Obsidian 完整使用手册 02：Markdown 语法篇

Obsidian 使用 Markdown 作为笔记格式语言。本文详细讲解 Obsidian 支持的所有 Markdown 语法，包括标准 Markdown 和 Obsidian 特有的扩展语法。

Markdown 简介

Markdown 是一种轻量级标记语言，使用纯文本格式编写，通过简单的符号标记来定义文档结构。Obsidian 使用 Markdown 作为底层文件格式，这意味着：

你的笔记是纯文本文件，永远不会过时
即使不使用 Obsidian，任何文本编辑器都能打开你的笔记
可以轻松进行版本控制（如 Git）

标题

使用 # 号标记标题，# 的数量表示标题层级。

markdown 复制代码

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

规则：

# 和标题文字之间需要有一个空格
一个笔记中最好只使用一个一级标题
标题会自动出现在"大纲"面板中
标题可以作为锚点链接目标

段落与换行

段落：用空行分隔的文本块。

markdown 复制代码

这是第一段文字。
这里还是第一段（因为没空行）。

这是第二段文字。

换行：在行尾加两个空格然后回车，或者使用 <br> 标签。

markdown 复制代码

这是第一行。··（两个空格）
这是第二行。

或者使用 HTML 标签：
这是第一行。<br>
这是第二行。

文本样式

基础样式

markdown 复制代码

**粗体**
*斜体*
***粗斜体***
~~删除线~~
==高亮==（Obsidian 扩展）
`行内代码`
<u>下划线</u>（HTML 标签）

效果：

粗体
斜体
粗斜体
删除线
高亮
行内代码
++下划线++

组合使用

^myinface

markdown 复制代码

**粗体和*斜体*组合**
~~**删除线和粗体**~~

转义字符

使用反斜杠 \ 转义 Markdown 特殊字符：

markdown 复制代码

\*这不是斜体\*
\[这不是链接\]

列表

无序列表

使用 -、* 或 +：

markdown 复制代码

- 项目一
- 项目二
  - 子项目（缩进 2 或 4 个空格）
  - 子项目
- 项目三

效果：

项目一
项目二
- 子项目
- 子项目
项目三

有序列表

使用数字加点号：

markdown 复制代码

1. 第一步
2. 第二步
3. 第三步
   1. 子步骤（缩进）
   2. 子步骤

效果：

第一步
第二步
第三步
1. 子步骤
2. 子步骤

注意：Obsidian 默认启用了"自动更新有序列表"功能，插入或删除项目后编号会自动调整。

混合列表

markdown 复制代码

1. 有序项
   - 无序子项
   - 无序子项
2. 有序项

引用

使用 > 符号创建引用块：

markdown 复制代码

> 这是一段引用。
> 这是同一引用中的另一行。

> 多段引用需要用空行分隔。

> 嵌套引用：
>> 这是嵌套引用
> 回到外层引用

效果：

这是一段引用。

这是同一引用中的另一行。

多段引用需要用空行分隔。

嵌套引用：

这是嵌套引用

回到外层引用

引用中可以使用其他 Markdown 语法：

markdown 复制代码

> **粗体**和*斜体*
> - 列表项
> `代码`

代码

行内代码

使用反引号包裹：

markdown 复制代码

使用 `print("Hello World")` 输出文本。

代码块

使用三个反引号或缩进 4 个空格：

markdown 复制代码

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

效果：

python 复制代码

def hello():
    print("Hello, Obsidian!")

支持的常用语言标识 ：python、javascript、typescript、html、css、bash、json、yaml、sql、rust、go、java、cpp、c 等。

无语法高亮的代码块

markdown 复制代码

```text
纯文本代码块，无语法高亮
```

分割线

使用三个或以上的 -、* 或 _：

markdown 复制代码

---
***
___

效果：

注意：在 Obsidian 中，单独一行的 --- 会被识别为 YAML Frontmatter 的边界。如果只是想插入分割线，建议在前后各加一个空行。

链接

外部链接

markdown 复制代码

[显示文本](https://obsidian.md)

[带有标题的链接](https://obsidian.md "点击访问 Obsidian 官网")

直接显示 URL：<https://obsidian.md>

内部链接（Obsidian 核心功能）

详见 03-双向链接与图谱篇。

markdown 复制代码

[[笔记名称]]
[[笔记名称|显示文本]]
[[笔记名称#标题]]
[[笔记名称#^块引用ID]]

图片

markdown 复制代码

![替代文本](https://example.com/image.png)

![本地图片](assets/example.png)

![带标题的图片](assets/example.png "图片标题")

!![[附件图片.png]]  <!-- Obsidian 内部链接方式 -->

调整图片大小（Obsidian 支持）：

markdown 复制代码

![替代文本|100](assets/example.png)  <!-- 宽度 100px -->
![替代文本|x200](assets/example.png) <!-- 高度 200px -->
![替代文本|300x200](assets/example.png) <!-- 宽 300px 高 200px -->

表格

使用 | 和 - 创建表格：

markdown 复制代码

| 左对齐 | 居中对齐 | 右对齐 |
|:---|:---:|---:|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |

效果：

左对齐	居中对齐	右对齐
单元格 1	单元格 2	单元格 3
单元格 4	单元格 5	单元格 6

对齐方式：

:--- --- 左对齐
:---: --- 居中对齐
---: --- 右对齐

表格内格式：

markdown 复制代码

| 功能 | 语法 |
|:---|:---|
| **粗体** | `**文本**` |
| `代码` | 反引号 |
| [链接](https://obsidian.md) | `[文本](URL)` |

任务列表

使用 - [ ] 和 - [x] 创建任务列表：

markdown 复制代码

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个任务
  - [ ] 子任务（缩进）
- [x] 已完成

效果：

快捷键 ：在任务项上按 Ctrl/Cmd + Enter 可切换任务状态。

脚注

markdown 复制代码

这是一个带有脚注的句子[^1]。这是另一个脚注[^longnote]。

[^1]: 这是第一个脚注的内容。
[^longnote]: 这是较长的脚注内容，可以包含多行文字。
    第二行需要缩进。

注意：在阅读模式下，脚注会显示在页面底部；在编辑模式下需要预览才能看到效果。

Obsidian 扩展语法

高亮

markdown 复制代码

==这是高亮文本==

内部链接（Wiki 链接）

markdown 复制代码

[[笔记名称]]
[[笔记名称|自定义显示文本]]
[[笔记名称#标题]]
[[笔记名称#^块引用ID]]
[[笔记名称#^块引用ID|自定义显示文本]]

嵌入文件

使用 ! 前缀嵌入其他文件的内容：

markdown 复制代码

![[其他笔记]]

![[附件图片.png]]

![[文档.pdf#page=2]]

![[笔记#标题]]

块引用

给特定段落添加唯一标识符，方便引用：

markdown 复制代码

这是一段需要引用的内容。
^block-id-123

在另一篇笔记中引用：
[[笔记名称#^block-id-123]]

创建块引用 ID 的方式：

在段落末尾输入 ^唯一标识符
或者使用命令面板中的"添加块引用"命令

注释

使用 %% 创建注释，注释内容只在编辑模式下可见：

markdown 复制代码

这是可见内容。

%%这是注释，在阅读模式下不可见%%

这是多行注释：
%%
第一行注释
第二行注释
第三行注释
%%

LaTeX 数学公式

Obsidian 支持 LaTeX 数学公式渲染，使用 MathJax 引擎。

行内公式

markdown 复制代码

爱因斯坦的质能方程 $E = mc^2$ 是著名的物理公式。

公式块

markdown 复制代码

$$
\frac{d}{dx}\left( \int_{a}^{x} f(t)\,dt\right) = f(x)
$$

常用公式示例

希腊字母：

markdown 复制代码

$\alpha$ $\beta$ $\gamma$ $\delta$ $\epsilon$ $\theta$
$\pi$ $\sigma$ $\omega$ $\Delta$ $\Sigma$ $\Omega$

上下标：

markdown 复制代码

$x^2$ $x^{y+z}$ $x_n$ $x_{ij}$ $e^{i\pi} + 1 = 0$

分数：

markdown 复制代码

$\frac{1}{2}$ $\frac{a+b}{c+d}$

根号：

markdown 复制代码

$\sqrt{x}$ $\sqrt[3]{y}$ $\sqrt[n]{a+b}$

求和与积分：

markdown 复制代码

$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$
$\int_{a}^{b} f(x) dx$

矩阵：

markdown 复制代码

$$
\begin{pmatrix}
a & b \\
c & d
\end{pmatrix}
$$

方程组：

markdown 复制代码

$$
\begin{cases}
x + y = 10 \\
2x - y = 5
\end{cases}
$$

Mermaid 图表

Obsidian 原生支持 Mermaid 图表渲染，可以在笔记中创建流程图、时序图、甘特图等。

流程图

markdown 复制代码

```mermaid
graph TD
    A[开始] --> B{判断}
    B -->|是| C[处理]
    B -->|否| D[结束]
    C --> D
```

时序图

markdown 复制代码

```mermaid
sequenceDiagram
    Alice->>John: 你好 John
    John-->>Alice: 你好 Alice
    Alice->>John: 你最近怎么样？
    John-->>Alice: 我很好，谢谢！
```

甘特图

markdown 复制代码

```mermaid
gantt
    title 项目计划
    dateFormat  YYYY-MM-DD
    section 阶段一
    调研        :a1, 2026-01-01, 30d
    设计        :a2, after a1, 20d
    section 阶段二
    开发        :b1, after a2, 60d
    测试        :b2, after b1, 20d
```

类图

markdown 复制代码

```mermaid
classDiagram
    class Animal {
        +String name
        +makeSound() void
    }
    class Dog {
        +bark() void
    }
    Animal <|-- Dog
```

饼图

markdown 复制代码

```mermaid
pie
    title 时间分配
    "工作" : 40
    "学习" : 25
    "休息" : 20
    "其他" : 15
```

状态图

markdown 复制代码

```mermaid
stateDiagram-v2
    [*] --> 待处理
    待处理 --> 处理中
    处理中 --> 已完成
    处理中 --> 已失败
    已完成 --> [*]
    已失败 --> 处理中
```

ER 图

markdown 复制代码

```mermaid
erDiagram
    CUSTOMER ||--o{ ORDER : places
    ORDER ||--|{ LINE-ITEM : contains
    CUSTOMER {
        string name
        string email
    }
```

YAML Frontmatter

YAML Frontmatter 是位于笔记开头的元数据区域，用 --- 包裹。

基本语法

markdown 复制代码

---
title: 笔记标题
created: 2026-05-19
tags:
  - 技术
  - obsidian
aliases:
  - 别名
  - 另一个别名
---

常用字段

字段	用途	示例
`title`	笔记标题	`title: 我的笔记`
`created`	创建日期	`created: 2026-05-19`
`updated`	更新日期	`updated: 2026-05-20`
`tags`	标签列表	`tags: [编程, Python]`
`aliases`	别名	`aliases: [别名1, 别名2]`
`author`	作者	`author: 张三`
`status`	状态	`status: 已完成`

属性面板

Obsidian 提供了可视化的属性面板来编辑 Frontmatter：

在笔记顶部可以直接看到属性面板
点击"添加属性"按钮
选择属性类型（文本、数字、标签、日期等）
输入属性值

属性类型

类型	格式	示例
文本	纯文本	`author: 张三`
数字	数字	`priority: 5`
标签	标签列表	`tags: [科技, 编程]`
日期	YYYY-MM-DD	`date: 2026-05-19`
时间	HH:MM	`time: 14:30`
复选框	true/false	`draft: true`

快捷键速查表

操作	Windows/Linux	macOS
粗体	`Ctrl + B`	`Cmd + B`
斜体	`Ctrl + I`	`Cmd + I`
删除线	`Ctrl + Shift + S`	`Cmd + Shift + S`
行内代码	`Ctrl + Shift +` `	`Cmd + Shift +` `
代码块	`Ctrl + Shift + C`	`Cmd + Shift + C`
插入链接	`Ctrl + K`	`Cmd + K`
插入图片	`Ctrl + Shift + K`	`Cmd + Shift + K`
插入任务	`Ctrl + L`	`Cmd + L`
插入标签	`#`	`#`
插入内部链接	`[[`	`[[`
提升标题级别	`Ctrl + Shift + ]`	`Cmd + Shift + ]`
降低标题级别	`Ctrl + Shift + [`	`Cmd + Shift + [`
切换项目符号	`Ctrl + Shift + 0`	`Cmd + Shift + 0`
缩进列表项	`Tab`	`Tab`
减少缩进	`Shift + Tab`	`Shift + Tab`

下一步

03-双向链接与图谱篇 --- 学习如何连接笔记
08-进阶使用技巧篇 --- 更多编辑技巧

Obsidian 完整使用手册 02：Markdown 语法篇