以下是精简全面的 Markdown 语法指南，涵盖基础语法、多引擎差异及 Obsidian 独有语法，以表格形式直观对比：
一、基础通用语法（所有环境支持）
| 语法 | 写法 | 效果 | 说明 |
|---|
| 标题 | # H1 ~ ###### H6 | 分级标题 | # 后需加空格 |
| 粗体 | **文本** 或 __文本__ | 文本 | 符号紧贴文本 |
| 斜体 | *文本* 或 _文本_ | 文本 | 同上 |
| 代码块 | ```语言 + 换行代码 + ``` | 语法高亮的代码块 | 语言名如 python、bash |
| 行内代码 | `代码` | print() | 反引号包裹 |
| 引用 | > 文本 | > 引用内容 | 支持多层嵌套 >> |
| 无序列表 | - 项 或 * 项 | - 列表项 | Tab 缩进创建子列表 |
| 有序列表 | 1. 项 | 1. 自动编号 | 数字实际值不影响排序 |
| 链接 | URL | https://example.com | 外部链接标准格式 |
| 图片 | !图片路径 | 显示图片 | 支持相对/绝对路径 |
| 表格 | |列1|列2| + |--| | 对齐的表格 | :--: 居中，:-- 左对齐 |
| 分隔线 | --- 或 *** | 水平分割线 | 至少三个符号 |
二、多引擎扩展语法差异
| 语法 | 支持环境 | 写法 | 效果/说明 |
|---|
| 任务列表 | GitHub/Typora | - [x] 完成 | 勾选框（[ ] 未完成） |
| 高亮 | Typora/VS Code | ==文本== | ==高亮文本== |
| 数学公式 | Typora/VS Code | $E=mc^2$（行内） | LaTeX 语法 |
| 流程图 | Typora/VS Code | ```mermaid + 流程图代码 | Mermaid 图表渲染 |
| 目录生成 | Typora/GitHub | [TOC] | 自动生成标题目录 |
| 注释 | Obsidian | %%隐藏内容%% | 仅在编辑模式显示 |
三、Obsidian 独有语法
| 语法 | 写法 | 效果/说明 |
|---|
| 双链笔记 | [[目标笔记]] | 内部链接，自动生成知识图谱 |
| 链接别名 | [[目标笔记|别名]] | 显示为“别名”而非文件名 |
| 标签系统 | #标签 | 支持嵌套标签（#父标签/子标签） |
| 标注块 | > [!info] + 内容 | 彩色提示块（类型：info/tip/warning/danger 等） |
| 标注嵌套 | > [!todo] > > [!sub] | 多级嵌套标注 |
| 图片尺寸控制 | ![[图.jpg|100x200]] | 指定宽高（100 仅宽） |
| Front Matter 元数据 | 笔记顶部写：
---
tags: 标签
--- | 定义文档属性（标签、别名等） |
| 嵌入内容 | ![[笔记#标题]] | 嵌入其他笔记的指定段落 |
四、兼容性说明
- 基础语法（如标题、列表）在所有 Markdown 引擎中通用。
- 扩展语法（如公式、流程图）需环境支持插件（如 VS Code 的 Markdown All in One）。
- Obsidian 特性（如双链、标注块）仅在其内部生效，其他工具可能显示为普通文本或链接。
💡 实践建议：
- 跨平台写作优先用基础语法 + GFM 扩展（任务列表、表格）。
- Obsidian 用户可深度使用双链和标注构建知识网络。
💬 评论