Markdown 语法速查表：行内格式、块元素、表格、扩展语法一网打尽 — Markdown Syntax Quick Reference: Inline, Block, Tables & Extended Syntax

"Markdown 的表格怎么写来着？代码块怎么指定语言？脚注怎么添加？删除线是一个波浪线还是两个？"——每次写文档都要去查语法太浪费时间了。

收藏本页即可——我们按功能分类整理了所有 Markdown 语法，每条语法都附带写法示例和渲染效果说明。你再也不需要在搜索引擎和文档之间反复切换。

01 行内格式化（Inline Formatting）

行内格式化用于在段落内部对文字进行样式标记。它们不会创建新的块级元素，而是直接修饰所在位置的文字。

行内格式化速查表

块级元素独占一行或多行，用于构建文档的主体结构。它们是 Markdown 文档的骨架。

块级元素速查表

行内代码用单反引号包裹 `code`，适合展示变量名、函数名、简短命令。代码块用三个反引号围栏并指定语言名，实现语法高亮。

常用语言标记：javascript / js、typescript / ts、python / py、html、css、json、bash / shell、sql、java、c / cpp、go、rust、yaml、markdown / md。

如果不知道语言标记，可以不写（使用纯文本模式）。缩进 4 个空格也可以创建代码块（旧语法），但围栏式代码块更清晰推荐。

在代码块的语言标记后加 {1,3-5} 可以在某些渲染器中实现代码行高亮（非标准 Markdown，但 VitePress、Docusaurus 等支持）。

Markdown 表格使用管道符 | 分隔列，第二行用 --- 分隔表头和内容。对齐方式通过冒号位置控制。

表格对齐语法

以下语法属于扩展 Markdown（主要来自 GitHub Flavored Markdown 或其他方言），不是所有渲染器都支持，但在现代 Markdown 工具中已经得到广泛支持。

Markdown 中怎么插入换行而不是新段落？

在行末添加两个或更多空格，然后按 Enter。或者使用 HTML 的 <br> 标签。单独按 Enter 只会生成一个空格，不会换行——这是 Markdown 最常让新手困惑的特性。

Markdown 表格可以合并单元格吗？

原生 Markdown 不支持合并单元格。如果需要合并单元格，可以直接在 Markdown 中嵌入 HTML <table> 标签，使用 rowspan 和 colspan 属性。

CommonMark 和 GFM 有什么区别？

CommonMark 是 Markdown 的标准化规范，定义了核心语法的精确行为。GFM（GitHub Flavored Markdown）是 CommonMark 的超集，添加了表格、任务列表、删除线、自动链接等扩展。Suried 编辑器兼容 GFM。

如何在 Markdown 中转义特殊字符？

在特殊字符前加反斜杠 \：\* 显示星号、\# 显示井号、\[ 显示方括号等。需要转义的字符包括：\ ` * _ { } [ ] ( ) # + - . ! |

这张速查表适用于所有 Markdown 编辑器吗？

基础语法（标题、粗体、列表、链接、代码等）在所有 Markdown 编辑器中通用。扩展语法（脚注、高亮、数学公式等）的支持取决于具体编辑器。Suried Markdown 编辑器支持本表中列出的所有语法。

📖

收藏本页即可——我们按功能分类整理了所有 Markdown 语法，每条语法都附带写法示例和渲染效果说明。你再也不需要在搜索引擎和文档之间反复切换。