内容纲要
下面是一份《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"></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 不是记事本,是“个人知识操作系统”
建议你优先掌握:
[[双链]]![[嵌入]]#标签CalloutDataview