Obsidian
Obsidian 扩展 Markdown
Obsidian 在标准 Markdown 之上支持的语法扩展一览。
Obsidian 在 CommonMark、GitHub Flavored Markdown 与 LaTeX 基础上,增加了面向知识管理的扩展,力求能力更强且尽量不破坏已有格式。
HTML 标签内的 Markdown 不会被解析(性能与设计取舍)。例如
<div>**不会加粗**</div>。
扩展语法对照表
| 语法 | 说明 | 详见 |
|---|---|---|
[[链接]] | 仓库内笔记/文件链接 | 内部链接 |
![[链接]] | 嵌入文件 | 嵌入与标注 |
![[链接#^id]] | 嵌入或链接到块 | 内部链接 · 块引用 |
^id | 定义块 ID | 同上 |
[^id] | 脚注 | 基础语法 · 脚注 |
%%文字%% | 编辑时可见的注释 | 基础语法 · 注释 |
~~文字~~ | 删除线 | 基础语法 · 文本样式 |
==文字== | 高亮 | 同上 |
``` | 代码块 | 基础语法 · 代码 |
- [ ] / - [x] | 任务列表 | 基础语法 · 列表 |
> [!note] | 标注 Callout | 嵌入与标注 |
表格 | | GFM 表格 | 进阶排版 · 表格 |
$...$ / $$...$$ | 数学公式 | 进阶排版 · 数学公式 |
Wikilink 与 Markdown 链接
默认使用 [[ ]]。关闭 设置 → 文件与链接 → 使用 Wikilink 后,自动补全仍可用 [[,但生成 [文字](文件.md) 格式,便于与其他工具交换。
属性(Properties)
笔记顶部 YAML 区(frontmatter)可写 aliases、tags 等元数据,供搜索、Bases、别名链接使用。示例见 内部链接 · 别名。
与标准 Markdown 文档的关系
若你熟悉 GitHub / 通用 Markdown,只需额外掌握:双链、嵌入、块引用、高亮、标注 五项,即可覆盖 Obsidian 大部分写作场景。
最后更新时间: 2026-06-18 02:53:47