Obsidian 全部语法手册

内容纲要

下面是一份《Obsidian 全部语法手册(实战版)》,目标是:
一次看懂、随查随用、不再到处翻资料
内容按「从 Markdown → Obsidian 增强 → 高阶知识管理」逐层展开。


一、基础 Markdown 语法(Obsidian 完整支持)

1️⃣ 标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

2️⃣ 强调

**加粗**
*斜体*
***加粗+斜体***
~~删除线~~
==高亮==

效果:

  • 加粗
  • 斜体
  • 强调
  • 删除线
  • ==高亮==

3️⃣ 列表

无序列表

- 项目
- 项目
  - 子项目

有序列表

1. 第一项
2. 第二项

任务列表(非常核心)

- [ ] 待办
- [x] 已完成

4️⃣ 引用

> 这是引用
>> 嵌套引用

5️⃣ 代码

行内代码

`code`

代码块

```python
def hello():
    print("Hello Obsidian")

支持几乎所有语言高亮。

---

## 6️⃣ 分割线
```md
---
***
___</code></pre>
<hr />
<h2>7️⃣ 链接 & 图片</h2>
<h3>普通链接</h3>
<pre><code class="language-md">[文字](https://example.com)</code></pre>
<h3>图片</h3>
<pre><code class="language-md">![描述](image.png)</code></pre>
<hr />
<h2>8️⃣ 表格</h2>
<pre><code class="language-md">| 名称 | 说明 |
|----|----|
| A  | 内容 |
| B  | 内容 |</code></pre>
<hr />
<h1>二、Obsidian 核心增强语法(重点)</h1>
<h2>9️⃣ 内部链接(双链,Obsidian 灵魂)</h2>
<pre><code class="language-md">[[笔记名]]
[[笔记名|显示文本]]</code></pre>
<h3>链接到标题</h3>
<pre><code class="language-md">[[笔记名#标题]]</code></pre>
<h3>链接到块(Block Reference)</h3>
<pre><code class="language-md">[[笔记名^block-id]]</code></pre>
<hr />
<h2>🔟 嵌入内容(Embed)</h2>
<pre><code class="language-md">![[笔记名]]
![[笔记名#某个标题]]
![[笔记名^block-id]]</code></pre>
<p>📌 用于:</p>
<ul>
<li>知识复用</li>
<li>MOC / 汇总页</li>
<li>文档拼装</li>
</ul>
<hr />
<h2>1️⃣1️⃣ 标签(Tag)</h2>
<pre><code class="language-md">#标签
#标签/子标签</code></pre>
<p>例:</p>
<pre><code class="language-md">#AI
#AI/Agent
#读书/方法论</code></pre>
<hr />
<h2>1️⃣2️⃣ 别名(Alias)</h2>
<pre><code class="language-md">---
aliases: [别名1, 别名2]
---</code></pre>
<p>或:</p>
<pre><code class="language-md">aliases: 别名</code></pre>
<hr />
<h2>1️⃣3️⃣ Frontmatter(YAML 头)</h2>
<pre><code class="language-md">---
title: 标题
tags: [AI, Agent]
created: 2026-01-27
status: draft
---</code></pre>
<p>📌 用于:</p>
<ul>
<li>Dataview</li>
<li>笔记元数据</li>
<li>系统化管理</li>
</ul>
<hr />
<h2>1️⃣4️⃣ 脚注</h2>
<pre><code class="language-md">这是一个说明[^1]

[^1]: 脚注内容</code></pre>
<hr />
<h2>1️⃣5️⃣ 注释(不渲染)</h2>
<pre><code class="language-md">%% 这是注释 %%</code></pre>
<hr />
<h1>三、Obsidian 独有 Block 能力</h1>
<h2>1️⃣6️⃣ Block ID(块引用)</h2>
<pre><code class="language-md">这是一段文字 ^block-id</code></pre>
<p>引用:</p>
<pre><code class="language-md">![[这篇笔记^block-id]]</code></pre>
<hr />
<h2>1️⃣7️⃣ Callout(提示块,强烈推荐)</h2>
<pre><code class="language-md">> [!note]
> 这是说明</code></pre>
<p>常用类型:</p>
<pre><code class="language-md">> [!info]
> [!tip]
> [!warning]
> [!danger]
> [!example]
> [!quote]</code></pre>
<p>折叠:</p>
<pre><code class="language-md">> [!note]- 可折叠</code></pre>
<hr />
<h1>四、Dataview(进阶核心)</h1>
<h2>1️⃣8️⃣ Dataview 查询</h2>
<pre><code class="language-md">```dataview
table created, status
from "笔记路径"
where contains(tags, "AI")
sort created desc</code></pre>
<pre><code>
### 列表
```md
```dataview
list
from #AI</code></pre>
<pre><code>
---

## 1️⃣9️⃣ DataviewJS(脚本级)

```md
```dataviewjs
dv.list(dv.pages("#AI").file.name)</code></pre>
<pre><code>
---

# 五、Canvas / 白板相关

## 2️⃣0️⃣ Canvas 链接
```md
[[canvas.canvas]]

Canvas 中可直接拖入:

  • 笔记
  • 图片
  • 链接
  • 查询结果

六、Mermaid 图表(系统表达神器)

```mermaid
graph TD
A[开始] --> B[处理]
B --> C[结束]

支持:
- 流程图
- 时序图
- 甘特图
- 状态机

---

# 七、快捷但容易忽略的细节

## 2️⃣1️⃣ 数学公式(LaTeX)
```md
$E=mc^2$

$$
\int_0^1 x^2 dx
$$

2️⃣2️⃣ HTML(Obsidian 支持)

<details>
<summary>点击展开</summary>
内容
</details>

2️⃣3️⃣ 转义字符

\* \# \[ \]

八、推荐的「终极结构模板」

---
title:
aliases:
tags:
created:
---

## 一句话结论

> [!summary]
> 结论内容

## 核心要点

## 结构拆解

## 示例 / 代码

## 延伸链接
- [[相关笔记]]

九、你现在该怎么用(给你一句实话)

Obsidian 不是记事本,是“个人知识操作系统”

建议你优先掌握:

  1. [[双链]]
  2. ![[嵌入]]
  3. #标签
  4. Callout
  5. Dataview
close
arrow_upward