第 7 章 引用、表格与定义列表
本章覆盖：
| 语法 | 形式 | 范围 |
|---|---|---|
| 引用 Blockquote | > |
CommonMark |
| 多行引用 | 连续 > |
CommonMark |
| 嵌套引用 | >> |
CommonMark |
| 引用含其它元素 | 段落/列表/代码 | CommonMark |
| 表格 | | col | col | |
GFM |
| 表格对齐 | :--- :---: ---: |
GFM |
| 定义列表 | 术语 + : 描述 |
Markdown Extra / Pandoc |
7.1 单行引用
源码：
> 这是一段引用。渲染效果：渲染为带左侧竖线的引用块。
7.2 多行引用
源码：
> 这是第一行引用。
> 这是第二行引用。或简写（仅首行 > ，后续行自动归属）：
> 这是第一行引用。
这是第二行引用。渲染效果：两行同属一段引用。
7.3 多段引用
源码：
> 第一段引用。
>
> 第二段引用。渲染效果：引用块内含两段，第二段有空行隔开。
7.4 嵌套引用
源码：
> 外层引用
>> 内层嵌套引用
> 外层继续渲染效果：内层引用在外层引用之内，左侧双竖线。
7.5 引用中含其它元素
7.5.1 引用含列表
源码：
> 引用含列表：
>
> - 第一项
> - 第二项渲染效果：引用块内含无序列表。
7.5.2 引用含代码块
源码：
> 引用含代码：
>
> ```python
> print("hi")
> ```渲染效果：引用块内含 Python 代码块。
7.5.3 引用含标题
源码：
> ## 引用内的二级标题
> 段落正文。渲染效果：引用块内含 H2 与段落。
7.6 表格（GFM）
源码：
| 名称 | 数量 | 单价 |
| --- | --- | --- |
| 苹果 | 3 | 4.5 |
| 香蕉 | 2 | 3.0 |渲染效果：一个三列两行的表格。
7.7 表格对齐
源码：
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| A | B | C |
| 长文本 | 中 | 数值 |渲染效果：第一列左对齐，第二列居中，第三列右对齐。
7.8 简化表格
源码：
名称|数量
---|---
苹果|3
香蕉|2渲染效果：与完整写法等价，两端与多余空格可省略。
7.9 表格内强调
源码：
| 名称 | 说明 |
| --- | --- |
| **重点** | 重要项目 |
| ~~删除~~ | 已删除 |
| `code` | 代码 |渲染效果：表格单元格内支持粗体、删除线、行内代码等强调。
7.10 表格内换行
单元格内不支持多行；如需换行用 <br>：
源码：
| 名称 | 说明 |
| --- | --- |
| 第一项 | 第一行<br>第二行 |渲染效果：第二列单元格内换行显示。
7.11 表格局限
- 不支持单元格合并（
colspan/rowspan），复杂表格需用 HTML<table> - 不支持嵌套表格
- 列宽由内容自适应
7.12 定义列表（Markdown Extra / Pandoc）
源码：
Markdown
: 轻量级标记语言
HTML
: 超文本标记语言
: 浏览器渲染语言渲染效果：术语 Markdown 与 HTML 后跟其定义（HTML 项含两条定义）。
注意：CommonMark 与 GFM 不支持定义列表，需 Markdown Extra、Pandoc、PHP Markdown 等方言。
7.13 综合实例
源码：
## 文档片段
> 引用一句话。
>
> - 引用内列表
> - 第二项
| 名称 | 类型 | 说明 |
| :--- | :---: | ---: |
| Markdown | 标记语言 | 1 |
| HTML | 标记语言 | 2 |
术语
: 定义渲染效果：标题、含列表的引用块、带对齐的表格、一个定义项。
7.14 小结
- 引用用
>，可多段、可嵌套、可含任意元素 - 表格用
| |，分隔行用---，对齐用:指示 - 单元格内可含强调，换行用
<br> - 定义列表仅部分方言支持，必要时改用 HTML