Markdown 语法速查指南，涵盖基础语法、多引擎扩展及 Obsidian 独有语法。
基础通用语法
| 语法 | 写法 | 说明 |
|---|---|---|
| 标题 | # H1 ~ ###### H6 | # 后需加空格 |
| 粗体 | **文本** | 符号紧贴文本 |
| 斜体 | *文本* | 同上 |
| 代码块 | ```语言 包裹 | 语言名如 python |
| 行内代码 | `代码` | 反引号包裹 |
| 引用 | > 文本 | 支持嵌套 >> |
| 无序列表 | - 项 或 * 项 | Tab 缩进子列表 |
| 有序列表 | 1. 项 | 数字值不影响排序 |
| 链接 | [文字](URL) | 外部链接 |
| 图片 |  | 相对/绝对路径 |
| 分隔线 | --- | 至少三个符号 |
| 具体详见 CommonMark 核心规范。 |
多引擎扩展语法
CommonMark 之外的方言扩展，各引擎支持度不一：
| 语法 | 支持环境 | 写法 |
|---|---|---|
| 表格 | GFM 规范内，主流引擎均支持；严格 CommonMark 渲染器不渲染 | |列1|列2|，:--: 居中 |
| 任务列表 | GFM 规范内，GitHub/GitLab/Obsidian/Typora 均支持 | - [x] 完成 |
| 数学公式 | GitHub/GitLab/Obsidian/Typora | $E=mc^2$ |
| 流程图 | GitHub/GitLab/Obsidian/Typora | ```mermaid |
| 高亮 | Obsidian/Typora；GitHub 需 <mark> | ==文本== |
| 提示块 | GitHub Alerts 与 Obsidian 标注块同语法 | > [!note] |
| 目录 | 仅 Typora 等少数；GitHub 不渲染，GitLab 用 [[_TOC_]] | [TOC] |
Obsidian 独有语法
[[笔记]] # 双链：内部链接，知识图谱核心
[[笔记|别名]] # 别名：链接显示自定义文本
![[笔记#标题|标题]] # 嵌入：引用其他笔记的指定段落
![[图.png|100x200]] # 图片：指定宽高
#标签 # 标签：支持嵌套 #父/子
# 注释：源码可见，渲染时隐藏
> [!info] 标题 # 标注块：info/tip/warning/danger
> Frontmatter：文件顶部 --- 包围的 YAML 属性区，语法见 YAML
兼容性说明
- 基础语法：所有 Markdown 引擎通用
- 扩展语法：CommonMark 之外方言，各引擎支持度不一（见上表）
- Obsidian 特性：仅内部生效
- 底层机制：Markdown 最终编译为 HTML，内嵌 HTML 与实体解码规则见 Markdown与HTML的关系
跨平台写作优先使用基础语法 + GFM 扩展，Obsidian 用户可深度使用双链和标注构建知识网络。