第 3 章：列表
列表是组织信息的利器。无论是待办事项、操作步骤还是知识结构，列表都能让内容一目了然。
学习目标
- 掌握无序列表与有序列表的语法
- 理解嵌套列表的书写规则与缩进技巧
- 熟练使用任务列表（Checkbox）
- 了解列表内元素的混排方法
3.1 无序列表
用 -、* 或 + 作为列表标记：
markdown
- 项目一
- 项目二
- 项目三渲染：
- 项目一
- 项目二
- 项目三
应该用哪个符号？
三个符号渲染效果完全一样。推荐统一使用 -：
-是最通用的选择，GitHub、多数编辑器默认推荐*容易与粗体/斜体混淆+较少使用
🔑 关键原则：选择一个符号并在整个项目中保持一致。不要混用
-、*、+。
3.2 有序列表
用数字加点号：
markdown
1. 第一步
2. 第二步
3. 第三步渲染：
- 第一步
- 第二步
- 第三步
一个有趣的特性：序号可以不用管
Markdown 解析器会自动为你编号！下面这段：
markdown
1. 步骤一
1. 步骤二
1. 步骤三渲染出来依然是 1、2、3。这个特性非常实用：插入新步骤时不需要重编号。
⚠️ 但为了源码可读性，建议还是写正确的序号。当别人阅读你的 Markdown 源码时，正确的序号更有意义。
起始编号
如果需要从特定数字开始，可以这样：
markdown
3. 从三开始
4. 接下来是四渲染： 3. 从三开始 4. 接下来是四
3.3 任务列表（Checkbox）
任务列表是 GFM 的扩展语法，常用于待办事项：
markdown
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 又一个待办事项渲染：
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 又一个待办事项
语法要点
- [ ]：注意-后方、[前后都有一个空格x或X表示已完成（不区分大小写）- GitHub 上点击复选框可以直接切换状态！
markdown
- [x] ✅ 正确：空格完整
- [] ❌ 错误：方括号内无空格
-[ ] ❌ 错误：短横和方括号间无空格3.4 嵌套列表
基本嵌套
子列表需要缩进两个或四个空格（推荐四个空格，兼容性最好）：
markdown
- 主项目
- 子项目 A
- 子项目 B
- 子子项目 1
- 子子项目 2
- 另一个主项目
1. 有序子项 1
2. 有序子项 2渲染：
- 主项目
- 子项目 A
- 子项目 B
- 子子项目 1
- 子子项目 2
- 另一个主项目
- 有序子项 1
- 有序子项 2
缩进选择：2 空格 vs 4 空格
- 主项
- 子项（4 空格） ← 推荐：兼容性最广
- 子项（2 空格） ← 部分平台可用，但少数场景失效💡 强烈建议使用 4 个空格。GitHub 等平台对 4 空格缩进支持最稳定。
3.5 列表内包含其他元素
列表内包含段落
markdown
1. 第一项介绍。
这是第一项的详细描述，需要缩进四个空格或一个 Tab。
2. 第二项介绍。
第二项的详细描述。渲染：
第一项介绍。
这是第一项的详细描述，需要缩进四个空格或一个 Tab。
第二项介绍。
第二项的详细描述。
列表内包含代码块
代码块需要在列表缩进基础上再缩进：
markdown
- 功能说明：
```python
def hello():
print("Hello, World!")
```
- 另一项说明。列表内包含引用块
markdown
- 某位大佬说过：
> 代码如诗，结构如画。
> —— 某程序员
- 另一个条目。列表内包含图片
markdown
- 架构图如下：
- 下一个条目。💡 核心规则：列表内的嵌套元素（段落、代码块、引用、图片）都需要比列表标记额外缩进 4 个空格。
3.6 语法速查
| 语法 | 写法 | 说明 |
|---|---|---|
| 无序列表 | - 项目 | 推荐统一用 - |
| 有序列表 | 1. 项目 | 序号可自动递增 |
| 任务列表 | - [ ] 待办 | 空格很重要 |
| 已完成 | - [x] 已完成 | x 不区分大小写 |
| 嵌套 | 缩进 4 空格 | 兼容性最好的选择 |
| 列表内段落 | 额外缩进 4 空格 | 形成内容块 |
| 列表内代码 | 额外缩进 4 空格 | Tab + 代码块 |
本章小结
| 要点 | 说明 |
|---|---|
| 无序列表 | - 最推荐，全项目保持一致 |
| 有序列表 | 数字 + .，插入删除无需重新编号 |
| 任务列表 | - [ ]，空格是关键 |
| 嵌套 | 4 空格缩进，兼容性最好 |
| 嵌套元素 | 段落/代码/引用需在列表基础上再缩进 |
| GitHub 交互 | 任务列表在 GitHub 上可点击切换 |
下一章预告
列表让内容有了骨架，接下来给内容「联网」——学习链接与图片的插入方法。