Markdown 语法速查表
整理了 CommonMark 和 GitHub Flavored Markdown 的语法:标题、列表、表格、任务列表、代码和链接,并给出每种写法生成的 HTML。
Markdown 用少量符号把纯文本变成带格式的 HTML。这份速查表列出了 CommonMark(大多数工具遵循的标准)和 GitHub Flavored Markdown(增加了表格、任务列表、删除线和裸 URL 自动链接)的语法,并给出每个示例生成的准确 HTML。脚注、提示框等只有 GitHub.com 才会渲染的功能会单独标出,方便你知道哪里不能用。
使用方法
- 浏览表格,或在筛选框中输入“表格”“链接”等词。
- 用“显示”菜单把列表限定为 CommonMark、GFM 扩展或仅 GitHub 支持的功能。
- 把你自己的 Markdown 粘贴到“试一试”中,查看转换后的 HTML。
- 复制 HTML,或不断调整 Markdown 直到输出符合预期。
计算公式
Markdown 文本 → HTML(CommonMark + GFM 规则)
HTML 列和“试一试”输入框在浏览器中使用 marked 库的 GFM 模式生成,严格遵循 CommonMark 和 GFM 规范;在极少数边缘情况下,其他渲染器的结果可能不同。段落内的换行只有在行尾有两个空格或反斜杠时才会变成 <br>。
示例
在默认示例中,- [x] 牛奶 变成带有已勾选且禁用的复选框的列表项,面包 变成 <strong>面包</strong>,分隔行 | :--- | ---: | 让“商品”列左对齐、“数量”列右对齐(12 上带有 align="right")。npm test 两侧的反引号生成 <code>npm test</code>。
常见问题
CommonMark 和 GFM 有什么区别?
CommonMark 是对 Markdown 核心语法的精确规范。GitHub Flavored Markdown 是它的严格超集,增加了表格、任务列表、删除线、URL 自动链接,以及过滤不安全 HTML 的机制。
为什么我的单个换行不见了?
在 Markdown 中,段落内的单个换行会被当作空格。要强制换行,请在行尾加两个空格或一个反斜杠;要另起一段,请留一个空行。
脚注在所有地方都能用吗?
不能。GitHub.com、GitLab 和一些静态网站生成器支持 [^1] 脚注,但它不属于 CommonMark 或 GFM 规范,所以很多渲染器会把它显示为普通文本。
资料来源
最后更新:
包含这些输入的页面地址: https://kakao.mobile/zh/tools/markdown-cheat-sheet/
引用此工具
kakaoCalc. (2026, November 8). Markdown 语法速查表. https://kakao.mobile/zh/tools/markdown-cheat-sheet/
“Markdown 语法速查表.” kakaoCalc, 8 Nov. 2026, kakao.mobile/zh/tools/markdown-cheat-sheet/.