Markdown 语法速查表

渲染为加粗文字

加粗，用两个星号或两个下划线

渲染为斜体文字

斜体，用一个星号或一个下划线

渲染为加粗且斜体

同时加粗与斜体

文字中间加一条删除线

删除线（GFM 扩展，CommonMark 原生不支持）

灰底等宽文字

行内代码，用一个反引号包裹

嵌套行内样式

行内样式可以嵌套，但改用下划线写法更不容易出错

注意: 星号嵌套时边界的空格会让语法失效，例如 ** 粗 ** 不会生效

一条水平分割线

分割线，三个或更多减号（也可用星号或下划线）

注意: ⚠️ 减号写在文字正下方会被当成二级标题的 Setext 写法，好在前一行要空一行

显示为字面星号

反斜杠转义，把后面那个字符当作普通文本

注意: 能转义的符号是固定的那十几个 ASCII 标点，转义其他字符反斜杠会原样显示

强制换行，不产生新段落

行尾加两个空格强制换行

注意: 空格在编辑器里看不见，容易在格式化时被删掉；更稳的是写行尾反斜杠

强制换行，效果同上但可见

行尾写反斜杠强制换行，比两个空格更明显

插入一个不折行空格

直接写 HTML 实体，Markdown 会原样保留

渲染后不显示

注释，预览与渲染结果里都不会出现

最大的标题

一到六级标题，井号后必须有空格

注意: #标题 不写空格在多数解析器里不生效（部分平台做了兼容）

最小的标题

六级标题，超过六个井号会显示原文

上一行变成一级标题

Setext 写法，用等号把上一行变成一级标题

上一行变成二级标题

Setext 写法，用减号把上一行变成二级标题

给标题指定锚点 id

自定义锚点 id（不是标准 Markdown，GitHub 与常见站点另有自动生成规则）

注意: GitHub 的锚点是标题转小写加连字符，非 ASCII 会被丢掉，中文标题的锚点通常不可用

带序号的一项

有序列表，数字后跟点与空格

带序号的一项

有序列表的另一种写法，部分解析器不支持

缩进的子列表

嵌套列表，子项缩进两到四个空格

注意: 子项缩进不足会被当成同级项，缩进过多会变成代码块

带空复选框的一项

任务列表未完成态（GFM 扩展）

带勾选复选框的一项

任务列表已完成态，x 不区分大小写

同一项里的第二个段落

列表项里的多段内容，续段要与项内容对齐

列表项里的代码块

列表项里放围栏代码块，需按列表宽度缩进

序号从三开始且后续递增

有序列表的起始数字会生效，但后续序号由解析器递增

表头行

表格第一行是表头

分隔行，必须有

分隔行，表头下方必须有它，否则不渲染成表格

注意: 分隔行的竖线数量要与表头一致，列数对不上会被截断

左对齐与右对齐

冒号位置决定对齐：左侧左对齐、右侧右对齐

居中对齐

两端都写冒号就是居中

显示为竖线字符

单元格里要显示竖线必须转义

单元格内换行

单元格里换行用 HTML 的 br，Markdown 的换行语法在表格里失效

带语法高亮的代码块

围栏代码块，标记语言名可开启高亮

注意: 大多数实现省略语言名时不会高亮，写 text 或 txt 可以避免猜错

波浪号围栏代码块

用波浪号作围栏，适合代码块里本身就含反引号的情况

缩进式代码块

旧式代码块写法，围栏写法更好控制

内层含反引号的行内代码

内容含反引号时，用更多反引号包裹

一个超链接

行内式链接

带悬停标题的链接

链接可以附带标题，鼠标悬停时显示

自动识别为链接

尖括号包住 URL，自动成为链接

引用式链接

引用式链接，把长 URL 集中放在文末

一张图片

图片语法与链接只差一个感叹号

注意: 替代文字不能省：图片加载失败时它是唯一线索，也是无障碍读屏的内容

点击图片跳转

图片套链接，点击图片跳转

跳到页内某处

页内跳转，锚点规则由渲染器决定

跳到相对路径文件

相对路径链接，只在支持文件跳转的平台上可点

显示为字面方括号

链接文本里出现方括号时需要转义

左侧带竖线的段落

块引用，大于号后建议留一个空格

两级缩进的引用

嵌套引用，每层加一个大于号

引用里的第二个段落

引用里的空行也要带大于号，否则引用被切断

引用里的代码块

引用里放代码块，每一行都要带大于号

带强调的提示块

引用里可以再放强调与其他行内语法

带图标的提示块

GitHub 风格的提示块，另有 TIP / IMPORTANT / WARNING / CAUTION

注意: 只在 GitHub 与其衍生平台上生效，其他地方会退化成普通引用

脚注标记

脚注引用，正文里写标记，文末写定义

脚注定义

脚注定义，名字可以是任意标识符

渲染为一个表情

表情短代码，依赖平台的表情表

行内数学公式

行内数学公式，依赖 MathJax 或 KaTeX

注意: 绝大多数平台默认不开数学渲染，会原样显示美元符号

独立成行的公式

块级数学公式，同样依赖渲染器

渲染成图表

Mermaid 图表，平台需要内置支持

渲染为目录

自动目录，GitLab 与部分维基平台支持

注意: GitHub 不支持，会原样显示成文本

渲染为可点击的引用

议题引用与用户提及，属平台特性而非 Markdown 标准

强制换行

Markdown 里可直接写 HTML，多数平台允许

可折叠区块

折叠区块，常用于放长日志

注意: GitHub 会渲染它但不会解析块内的 Markdown（中间要空一行才解析）

指定宽度的图片

HTML 图片可以带属性，控制尺寸最常用

键帽样式

键盘按键样式，写文档时常用

两种粗体写法都生效

行内 HTML 与 Markdown 可以混用

注意: HTML 块级标签前后必须空行，否则 Markdown 不再解析其中内容