Obsidian Markdown 速查表

将此页面作为在 Obsidian 中最常用 Markdown 语法的复制粘贴参考。它涵盖了标准 Markdown、Obsidian 特有扩展（如双链/wikilinks 和 Callouts 标注），以及帮助您快速编辑笔记的快捷键。

Obsidian 基于 CommonMark 和 GitHub-Flavored Markdown，并为连接笔记添加了丰富功能：[[双链]]、![[嵌入]]、Callouts 标注、高亮、注释、块引用和属性（Properties）。标准 Markdown 通常是跨平台移植性更好的选择；而当笔记旨在仓库（Vault）内部高效协作时，Obsidian 特有语法则是更佳选择。

快速参考表

需求	语法	示例
标题	# 到 ######	## 项目笔记
加粗	**文本**	**重要**
斜体	*文本*	*可选*
删除线	~~文本~~	~~旧计划~~
高亮	==文本==	==决策==
外部链接	[标签](url)	[Obsidian 帮助](https://obsidian.md/help)
内部链接	[[笔记]]	[[项目简报]]
任务	- [ ]	- [ ] 发送跟进邮件
Callout 标注	> [!类型]	> [!tip] 尝试此工作流
嵌入笔记	![[笔记]]	![[会议纪要]]
行内代码	`代码`	`status: draft`
注释	%%文本%%	%%仅编辑时可见%%

文本格式与结构

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

**加粗文本**
*斜体文本* 或 _斜体文本_
***加粗且斜体文本***
~~删除线文本~~
==高亮文本==

> 块引用可以包含有用的摘录或提醒。

---

使用空行开始新段落。在段落中单独按 Enter 通常会在渲染出的笔记中视作软换行。如需硬换行，请使用 Shift+Enter 或在按 Enter 前添加两个空格。如果您需要跨编辑器的 Markdown 兼容行为，请检查 设置 → 编辑器 → 严格换行。

若要字面显示 Markdown 特殊字符，请使用反斜杠转义：

\*这不是斜体\*
1\. 这不是列表项
\# 这不是标题

列表、任务列表与嵌套

- 第一项
- 第二项
  - 嵌套项

1. 第一步
2. 第二步

- [ ] 待办任务
- [x] 已完成任务
  - [ ] 子任务

在阅读视图中，您可以点击任务复选框来切换状态。关于到期日、重复任务以及跨笔记查询，请参阅 Obsidian 任务管理完整指南。

链接与嵌入

内部链接

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

[[笔记名称]] 链接到仓库中的另一篇笔记。添加 | 自定义别名，# 链接到指定标题，或 #^ 链接到指定块。使用 ! 前缀即可进行嵌入而非仅生成链接：

![[笔记名称]]
![[笔记名称#标题]]
![[笔记名称#^块ID]]
![[图片.png]]
![[图片.png|400]]

当可复用的定义、会议决策或清单需要在多个地方显示，同时保持在单一源笔记中可编辑时，嵌入功能非常实用。

外部链接与图片

[Obsidian 帮助](https://obsidian.md/help)
![描述文本](https://example.com/image.png)

请使用具有描述性的链接文本。对于可能离开您仓库的笔记，标准 Markdown 链接比双链（wikilinks）更具通用移植性。

表格

表格需要标头行和分隔行。分隔行的每个单元格至少需要两个连字符：

| 状态 | 下一步行动 |
| --- | --- |
| 打开 | 今日审查 |
| 完成 | 归档笔记 |

在分隔行中使用冒号对齐列：

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| A | B | C |

在实时预览中，使用表格右键上下文菜单或 插入表格 命令添加行和列。如果表格未渲染，请检查以下常见原因：

• 在表格前添加一个空行。
• 保持分隔行紧贴标头行下方。
• 在单元格内部将字面管道符转义为 \|。
• 切勿在表格单元格中放入多行代码块；当示例需要多行时，请使用链接或嵌入笔记。

Callouts 标注框

Callouts 是具有特定样式的块引用。类型标识符控制图标和颜色；标题是可选的。

> [!tip] 简短标题
> 将建议紧贴其所解释的段落。

> [!warning]- 折叠警告
> 此内容初始为折叠状态。

常见的内置类型包括 note、abstract、info、todo、tip、success、question、warning、failure、danger、bug、example 和 quote。+ 后缀使可折叠标注框默认展开；- 后缀使其默认折叠。关于自定义 CSS 和故障排除，请参阅 Obsidian Callouts 完整指南。

代码、脚手架、注释与数学公式

使用单个反引号表示行内代码，使用三个反引号表示围栏代码块。添加语言标识符以实现语法高亮：

使用 `Ctrl+P` 打开命令面板。

```js
const noteType = "project";
```

脚注使用引用和定义：

Obsidian 将笔记存储为 Markdown 文件。[^1]

[^1]: 请在当前的 Obsidian 官方帮助文档中确认该行为。

注释在阅读视图和 Obsidian Publish 中会被隐藏：

可见文本 %%仅编辑器可见的提醒%%

对于数学公式，使用单个美元符号表示行内公式，使用双美元符号表示公式块：

行内公式：$a^2 + b^2 = c^2$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

值得记住的快捷键

这些是实用的默认设置，不能替代您自定义的快捷键配置：

操作	Windows/Linux	macOS
新建笔记	Ctrl+N	Cmd+N
命令面板	Ctrl+P	Cmd+P
无格式粘贴	Ctrl+Shift+V	Cmd+Shift+V
删除当前行（无需选中）	Ctrl+Shift+K	Cmd+Shift+K
选中文本加粗	Ctrl+B	Cmd+B
选中文本斜体	Ctrl+I	Cmd+I

Obsidian 将系统编辑快捷键与可自定义的命令热键区分开。打开 设置 → 快捷键 可以检查或更改命令，例如插入模板、打开每日笔记或运行插件操作。在非美式键盘布局上，显示的按键可能与物理键帽标签不一致。

实用格式决策表

如果您需要…	优先选择	原因
与其他 Markdown 编辑器共享笔记	标准 Markdown 链接、标题、列表和表格	这些是最具移植性的结构。
在一个仓库中连接笔记	双链 (Wikilinks) 和块引用	Obsidian 可以解析笔记名称并精确链接到特定章节。
复用清单或定义	嵌入 (Embed)	单一源文件更新即可在多个笔记中同时生效。
在不打断阅读体验的前提下解释决策	Callouts 标注框	内容保持可见但在视觉上处于次要地位。
跨每日笔记追踪工作	任务 + 统一模板	即使没有插件，任务语法也保持极佳可读性。

这种区分避免了一种常见错误：构建了一篇精美的笔记，但它只能在单一视图或单一应用中运行。从通用 portable Markdown 开始，仅在 Obsidian 特性能够消除实际摩擦时添加它们。

故障排除清单

当阅读视图中的格式看起来异常时，请按以下顺序检查语法：

1. 确认每个围栏代码块都有闭合的反引号。
2. 在新段落、表格、列表或 Callout 之前添加一个空行。
3. 检查字符 |、*、_、# 或反引号是否需要斜杠转义。
4. 对于表格，验证分隔行并从单元格中移除多行代码块。
5. 对于换行，故意使用 Shift+Enter、末尾两个空格或严格换行设置。
6. 如果命令无法运行，请在命令面板中搜索该命令并检查其分配的热键。

对于可复用的系统，格式化只是第一层。每日笔记模板、快速捕捉流、每周复盘和任务视图使笔记更容易付诸行动。Obsibrain 在 Obsidian 内部增加了这些规划与任务管理工作流。

官方参考资料

• 基础格式语法
• 高级格式语法
• Obsidian Flavored Markdown
• 编辑快捷键
• 热键设置
• Callouts 标注

继续阅读：Obsidian 链接指南、Callouts 标注指南 或 任务管理。