Markdown 速查表：语法参考与示例

本参考列出了每个常见的 Markdown 元素，配有一句话的简单说明和一个简短、可直接复制粘贴使用的代码块示例，方便随时查阅和练习使用。

标题、段落与换行

标题使用一到六个 # 字符后跟一个空格；# 越少标题越大。空行会开始新的段落。要在段落内强制换行，在行尾加两个空格或一个反斜杠。

# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.

强调、链接与图片

星号或下划线用于标记斜体和粗体文本，二者组合可同时得到两种效果。链接使用方括号表示文本，圆括号表示网址；图片使用相同语法并在前面加上 !。

*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](/path/to/image.png)

列表与嵌套列表

无序列表使用 -、* 或 +。有序列表使用数字加英文句点。用两个或四个空格缩进即可将一个列表嵌套在另一个列表中。

- item one
- item two
  - nested item
1. first
2. second

表格

GitHub Flavored Markdown 增加了管道表格。表头行下方的一行短横线用于设定列结构，也可以设定对齐方式。

| Name | Type |
| --- | --- |
| Alpha | text |
| Beta | number |

代码、引用与水平线

反引号标记行内代码，三个反引号则开启一个代码块，可选地标注语言以实现语法高亮。行首的 > 标记引用；堆叠多个 > 可实现嵌套引用。单独一行中的三个短横线、星号或下划线可绘制一条水平线。

Use `git status` to check the working tree.

print("hello")

> A quoted sentence.
>> A nested quote.

---

任务列表与转义

GitHub Flavored Markdown 在列表项中支持复选框。在特殊字符前加反斜杠可让它按字面打印，而不触发格式化。大多数渲染器也允许在行内使用原始 HTML 标签，不过本速查表只涉及纯粹的 Markdown 语法。

- [x] done
- [ ] not done

Escaped: \* not italic \*

GitHub Flavored Markdown 与 CommonMark 的对比

CommonMark 定义了核心规则：标题、强调、列表、链接、代码块和引用。GitHub Flavored Markdown 在 CommonMark 的基础上增加了表格、任务列表、删除线以及裸网址的自动链接。为其中一种规范编写的文件通常也能在另一种中正常渲染，但表格和复选框特别需要 GitHub Flavored Markdown 的支持。

扩展语法：数学公式、脚注、前置元数据与图表

这些扩展的支持情况因渲染器而异，因此在依赖它们之前请先检查目标工具。数学公式使用类似 LaTeX 的分隔符，脚注使用一个上标符号和一个标签，前置元数据是文件顶部的一个元数据块，图表使用带标签的代码块。

Inline math: $a^2 + b^2 = c^2$
Block math: $$E = mc^2$$

Text with a note.[^1]
[^1]: The note itself.

---
title: Example document
date: 2026-01-01
---

graph TD
  A --> B
  B --> C

综合运用

使用Markdown 编辑器编写并预览文档，使用Markdown Lint检查语法问题，并使用Markdown TOC生成目录。当你需要可分享的文件时，使用Markdown 转 PDF或Markdown 转 Word导出。要深入了解如何将 PDF 转换回 Markdown，请参阅PDF 转 Markdown 指南。