Markdown 语法完全指南：10 分钟学会，受益十年

Markdown 由 John Gruber 于 2004 年创造，核心理念是「易读易写」：用纯文本符号标记格式，双手不离键盘就能排出结构清晰的文档。GitHub、知乎、掘金、微信公众号编辑器、Notion、飞书文档——几乎所有写作平台都支持它。

学会 Markdown 的投入产出比极高：10 分钟学会基础语法，之后写 README、技术文档、笔记、博客的效率提升数倍。

标题用 # 号（一个 # 是一级标题，最多六级）；加粗用 **双星号**，斜体用 *单星号*；无序列表用 - 或 *，有序列表用 1. 2. 3.；引用用 >；行内代码用 `反引号` 包裹。

代码块用三个反引号开头结尾，开头注明语言可获得语法高亮；链接格式 [文字](网址)；图片格式 ；分割线用三个或更多的 ---。

表格是新手最容易卡壳的语法。第一行是表头，第二行用 |---|---| 分隔（冒号控制对齐：:--- 左对齐，:---: 居中，---: 右对齐），之后每行一条数据。手写表格容易对错不齐，建议先在在线编辑器中可视化编辑再复制源码。

代码块的语言标注很重要：```python、```javascript、```bash 等，标注后渲染器才能正确高亮。嵌套代码块时用四个反引号包裹三个反引号的内容。

练习语法最好的方式是实时预览。在线 Markdown 编辑器左右分屏，左边输入右边即时渲染，支持导出 HTML、PDF，适合写文档、排版公众号素材。

GitHub Flavored Markdown 在标准基础上增加了：待办列表 - [ ] / - [x]（Issue 中可勾选）、表格、删除线、@提及、#引用 Issue、围栏代码块语法高亮、任务进度等。写开源项目文档时这些都是标配。

数学公式：多数平台支持 LaTeX 语法，行内公式 $E=mc^2$，独立公式用双 $$ 包裹。流程图：GitHub、Typora 支持 mermaid 代码块直接渲染流程图、时序图、甘特图。

技巧一：善用引用块嵌套，> 后可以继续加 > 实现多层引用，适合写注释和补充说明。技巧二：HTML 标签兜底——Markdown 支持混写 HTML，居中、变色等特殊需求可用 <p align="center"> 实现。

技巧三：锚点跳转，长文档用 [跳转](#标题名) 实现目录导航。技巧四：图片加链接 [](链接) 实现点击图片跳转。技巧五：转义字符，需要显示 * # 等特殊符号时前面加反斜杠 \*。