4. 列表、引用与分割线
"组织内容的方式，决定文档的可读性。"
列表、引用和分割线是 Markdown 中用于组织和分隔内容的重要元素。它们帮助读者快速浏览、定位和理解文档结构。
4.1 列表详解
列表分为无序列表和有序列表，可以嵌套使用。
无序列表
使用 -、* 或 + 开头，后跟空格：
markdown
- 苹果
- 香蕉
- 橙子一致性：在一个文档中，建议统一使用同一种标记（推荐 -）。
有序列表
使用数字加点：
markdown
1. 准备工作
2. 安装依赖
3. 配置环境
4. 运行测试自动编号：Markdown 会自动重新编号，即使你写：
markdown
1. 第一
3. 第二
2. 第三渲染结果仍为 1、2、3。
嵌套列表
通过缩进创建子列表（建议 2 或 4 个空格）：
markdown
1. 一级项目
- 二级项目 A
- 二级项目 B
1. 三级项目
2. 三级项目
2. 另一个一级项目渲染：
- 一级项目
- 二级项目 A
- 二级项目 B
- 三级项目
- 三级项目
- 另一个一级项目
列表中的段落
列表项中可以包含多段落，但需要缩进：
markdown
- 第一项
这是第一项的第二个段落，需要缩进。
- 第二项任务列表
如前所述，使用 [ ] 或 [x]：
markdown
- [x] 完成文档
- [ ] 审核内容
- [ ] 发布网站4.2 引用详解
引用用于突出显示重要内容或引用他人言论。
单层引用
markdown
> 这是一段引用文字。多层引用
markdown
> 外层引用
> > 内层引用
> > > 更内层引用引用中的其他元素
引用块内可以包含标题、列表、代码等：
markdown
> **重要提示**
>
> - 请先备份数据
> - 确认环境变量已设置
>
> ```bash
> npm run build
> ```渲染：
重要提示
- 请先备份数据
- 确认环境变量已设置
bashnpm run build
引用来源
可以在引用末尾添加来源：
markdown
> 学而不思则罔，思而不学则殆。
> —— 孔子《论语》4.3 分割线（水平线）
分割线用于分隔文档的不同部分。
语法
至少三个 -、* 或 _，可以带空格：
markdown
---
***
___
- - -渲染效果都是：
使用场景
- 章节分隔：在长文档中分隔主要章节
- 主题转换：当话题发生转变时
- 视觉休息：避免大段文字造成的压迫感
- 替代分页：在打印或 PDF 中模拟分页效果
注意：
- 分割线前后通常留空行
- 不要滥用，否则会破坏文档连贯性
- 同一文档中保持风格一致（推荐
---）
4.4 列表与引用的组合
列表和引用可以嵌套使用：
markdown
> **引用标题**
>
> 1. 第一步
> 2. 第二步
> - 子步骤 A
> - 子步骤 B
> 3. 第三步或者：
markdown
- 任务一
> 引用说明
- 任务二
> 另一个引用4.5 常见问题
Q1: 列表项中的链接或图片不生效？
确保链接/图片语法正确，且列表项与内容之间有空格：
markdown
- [GitHub](https://github.com) ✅
-[GitHub](https://github.com) ❌（缺少空格）Q2: 嵌套列表的缩进混乱？
使用固定缩进（2 或 4 空格），不要混用 Tab 和空格。
Q3: 引用块中的代码块不显示高亮？
确保代码块标记正确：
markdown
> ```python
> print("Hello")
> ```Q4: 分割线在某些平台不显示？
某些解析器可能要求至少三个连续字符，不能有空格。
练习
- 创建一个包含三级嵌套的任务列表
- 编写一个引用块，其中包含一个有序列表和一个代码块
- 在长文档中合适位置添加分割线，观察渲染效果
上一篇: 3. 表格、代码与数学公式
下一篇: 5. Markdown 最佳实践与常见问题