# Markdown 速查表：语法参考与示例

> 本参考列出了每个常见的 Markdown 元素，配有一句话的简单说明和一个简短、可直接复制粘贴使用的代码块示例，方便随时查阅和练习使用。

- 页面: https://acepdfmd.com/zh-CN/guides/markdown-cheat-sheet/
- 更新日期: 2026-09-14
- 运行于: https://acepdfmd.com (上传的文件会在 60 分钟内删除。 轻度使用无需注册。)
- 另有 29 种语言版本: https://acepdfmd.com/<lang>/guides/markdown-cheat-sheet/

## 标题、段落与换行

标题使用一到六个 `#` 字符后跟一个空格；`#` 越少标题越大。空行会开始新的段落。要在段落内强制换行，在行尾加两个空格或一个反斜杠。

```
# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.
```

## 强调、链接与图片

星号或下划线用于标记斜体和粗体文本，二者组合可同时得到两种效果。链接使用方括号表示文本，圆括号表示网址；图片使用相同语法并在前面加上 `!`。

```
*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](https://acepdfmd.com/zh-CN/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.
```

```python
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
---
```

```mermaid
graph TD
  A --> B
  B --> C
```

## 综合运用

使用[Markdown 编辑器](https://acepdfmd.com/zh-CN/tool/markdown-editor/)编写并预览文档，使用[Markdown Lint](https://acepdfmd.com/zh-CN/tool/markdown-lint/)检查语法问题，并使用[Markdown TOC](https://acepdfmd.com/zh-CN/tool/markdown-toc/)生成目录。当你需要可分享的文件时，使用[Markdown 转 PDF](https://acepdfmd.com/zh-CN/tool/markdown-to-pdf/)或[Markdown 转 Word](https://acepdfmd.com/zh-CN/tool/markdown-to-word/)导出。要深入了解如何将 PDF 转换回 Markdown，请参阅[PDF 转 Markdown 指南](https://acepdfmd.com/zh-CN/guides/pdf-to-markdown-guide/)。

## 本指南提到的工具

- [Markdown 编辑器与预览](https://acepdfmd.com/zh-CN/tool/markdown-editor/): 使用实时丰富预览（表格、图像、任务列表）打开、编写和编辑 Markdown，可导出为 .md、PDF、Word 或 HTML。
- [Markdown 检查与格式化](https://acepdfmd.com/zh-CN/tool/markdown-lint/): 统一空行、标题、列表和表格的样式，并生成修改报告。
- [Markdown 目录](https://acepdfmd.com/zh-CN/tool/markdown-toc/): 根据标题自动生成并插入带链接的目录。
- [Markdown 转 PDF](https://acepdfmd.com/zh-CN/tool/markdown-to-pdf/): 将 .md 文件转换为格式化的 PDF。
- [Markdown 转 Word](https://acepdfmd.com/zh-CN/tool/markdown-to-word/): 将 .md 文件转换为可编辑的 DOCX。

## 更多指南

- [PDF 页面尺寸与规格：A4、Letter、Legal 等](https://acepdfmd.com/zh-CN/guides/pdf-page-sizes/)
- [PDF 压缩的原理，以及为什么有些文件几乎不会变小](https://acepdfmd.com/zh-CN/guides/pdf-compression-guide/)
- [PDF 转 Markdown：原理及在 AI 场景中的使用方法](https://acepdfmd.com/zh-CN/guides/pdf-to-markdown-guide/)
- [PDF 和图片的 OCR：如何获得准确的文字](https://acepdfmd.com/zh-CN/guides/ocr-guide/)
- [在线上传 PDF 安全吗？隐私指南](https://acepdfmd.com/zh-CN/guides/privacy-guide/)
- [在没有 Mac 的情况下打开和转换 Apple iWork 文件（Pages、Numbers、Keynote）](https://acepdfmd.com/zh-CN/guides/iwork-guide/)
- [JSON 工具指南：在文档、数据与 JSON 之间互相转换](https://acepdfmd.com/zh-CN/guides/json-guide/)
