嘿，朋友。如果你正在写博客、做笔记，或者在 GitHub 上提交 Issue，那你一定见过 Markdown。那种 * 和 - 交织出的清爽列表，简直是文字工作者的福音。但说实话，很多新手（包括曾经的我）在遇到“列表套列表”这种稍微复杂点的结构时，往往会瞬间崩溃：缩进不对了、序号乱了、甚至渲染出来的效果跟预览完全两样。
别担心，今天咱们不整那些虚头巴脑的理论，我就把这几年踩过的坑、整理过的经验，掰开了揉碎了讲给你听。咱们就像坐在咖啡馆里聊天一样，把这些排版的小秘密搞清楚。
为什么嵌套列表这么让人头秃？
首先得理解，Markdown 的核心逻辑其实是基于缩进的层级关系。对于无序列表（bullet points）来说，一个减号 - 或星号 * 就是一个节点；对于有序列表（numbered lists），一个数字加个点 1. 就是一个节点。
当你想要表达“包含”、“细分”或者“步骤中的子步骤”时，你就需要嵌套。这时候，问题就来了：空格到底要敲几个？ 是 2 个？4 个？还是 Tab 键？不同的编辑器、不同的渲染引擎（比如 GitHub 的 CommonMark、GitLab、或者某些静态博客生成器）对缩进的要求可能略有不同，但有一个“黄金标准”能让 99% 的情况都正常工作。
无序列表嵌套：空格的艺术
我们先从最简单的无序列表开始。
基础结构
假设你要列出一周的计划：
- 周一
- 上午：开会
- 下午：写代码
- 周二
- 上午：健身
注意看这里，上午：开会 这一行前面的空格。在大多数现代 Markdown 编辑器中，一级列表项的内容如果换行，通常需要缩进 2 到 4 个空格。而二级列表项（嵌套项）相对于一级列表项，也需要额外的缩进。
常见的“坑”：缩进不一致
很多人喜欢用 Tab 键来缩进。Tab 在有些地方代表 2 个空格，在有些地方代表 4 个空格，甚至有的浏览器显示为 8 个。这就导致了你本地看着没问题，发到网上发现列表断开了，或者嵌套层级错乱。
最佳实践： 永远使用空格，不要用 Tab。而且，保持全篇统一。我推荐4 个空格作为一个层级的缩进单位，这样兼容性最好。
让我们看一个详细的例子，展示如何清晰地嵌套三层：
- 项目 A
- 子任务 1
- 细节 1.1
- 细节 1.2
- 子任务 2
- 项目 B
- 子任务 3
在这个例子中：
- 项目 A是第一层，没有缩进。- 子任务 1是第二层，前面有 4 个空格。- 细节 1.1是第三层，前面有 8 个空格（4+4）。
关键点： 连字符 - 后面必须跟一个空格，否则它不会被识别为列表项，而会被当作普通文本。这是新手最容易犯的错误之一。
有序列表嵌套：数字的陷阱
有序列表比无序列表更麻烦，因为数字本身带有语义。
自动编号 vs 手动编号
Markdown 规范其实支持自动编号。也就是说，你只需要写 1.，后面的数字哪怕写成 2.、100. 甚至 .，渲染引擎通常都会自动修正为正确的序列。
但是，在嵌套结构中，保持一致性非常重要。
示例：配置文件的安装步骤
假设你在写一篇教程，教大家安装软件：
1. 下载安装包
2. 解压文件
1. 右键点击压缩包
2. 选择“解压到当前文件夹”
3. 确认解压后的目录结构正确
3. 运行安装程序
1. 双击 `setup.exe`
2. 按照向导点击“下一步”
3. 接受许可协议
4. 完成安装并重启
注意看第 2 步和第 3 步下面的嵌套。虽然我在源码里写了 1.、2.、3.，但在渲染后，它们会自动变成对应父级的 1.、2.、3.。
避坑指南：
- 不要在嵌套列表中强行手动计算数字。比如第一层是 1, 2, 3，第二层你也写 1, 2, 3，这是对的。但如果你第二层想写 4, 5, 6，虽然有些编辑器能识别，但为了可读性和维护性，建议始终从 1 开始。
- 空格必不可少。
1.后面必须有空格。如果你写成1.解压文件，很多解析器会把它当成普通段落，而不是列表项。
混合列表：无序套有序，有序套无序
有时候，你需要在一个有序的步骤中，列出多个可选的无序选项；或者在一个无序的清单中，列出每个项目的具体操作步骤。
场景一：有序列表中的无序子项
比如，“准备晚餐”的步骤：
1. 准备食材
- 土豆两个
- 牛肉一斤
- 洋葱一个
2. 切菜
- 土豆切块
- 牛肉切片
- 洋葱切丝
3. 烹饪
- 热锅凉油
- 先炒牛肉
- 再加入土豆
场景二：无序列表中的有序子项
比如，“如何修复这个 Bug”：
- 检查日志
1. 打开控制台
2. 搜索 "Error" 关键字
3. 记录报错行号
- 复现问题
1. 清除缓存
2. 重新加载页面
3. 尝试触发异常操作
这种混合写法非常实用，能让信息层次分明。记住，缩进规则不变：每一层嵌套增加 4 个空格（或你设定的固定缩进量）。
代码块中的列表：特殊处理
这是最容易出错的地方！如果你在 Markdown 文章中嵌入了代码示例，而代码示例本身又包含列表，你会遇到“列表失效”的问题。
因为代码块（用 “` 包裹）里的内容是纯文本，不会被解析为 Markdown 语法。但如果你不在代码块内，而是想让普通文本中的列表被正确识别，同时里面又包含代码片段，那就需要小心了。
错误示范
- 这是一个列表项
- 这里面有一段代码：`console.log('hello')`
- 还有另一段代码：
```javascript
console.log('world');
```
上面的写法在某些严格的渲染器中可能会导致列表中断，特别是当代码块前没有足够的缩进时。
正确做法：缩进代码块
在 Markdown 中，代码块如果是嵌套在列表项中的，必须比列表项多缩进 4 个空格（或者说，代码块的起始标记 ``` 需要位于列表内容的缩进基础上）。
看这个正确的例子：
- 第一步：初始化变量
- 声明变量 `let x = 0;`
- 确保变量作用域正确
- 查看完整代码示例：
```javascript
let x = 0;
let y = 10;
console.log(x + y);
```
注意看 ``` 前面的空格。它在代码块内部（如果代码块是缩进的），或者它需要相对于列表项有额外的缩进。具体来说：
- 第一步...是第一层。- 声明变量...是第二层，缩进 4 个空格。- `
javascript是第三层，缩进 8 个空格。
这样，渲染器才知道这个代码块是属于这个列表项的子内容，而不是一个新的、独立的代码块从而打断了列表的连续性。
常见排版错误大盘点
让我们总结一下那些让你抓狂的瞬间，以及如何避免它们。
1. 列表与段落之间的空白
有时候，你在列表中间插入了一个段落，结果列表突然结束了。
- 项目 A
这是一个普通的段落，不属于列表。
- 项目 B
渲染结果通常是：
- 项目 A 这是一个普通的段落，不属于列表。
- 项目 B （注意：项目 B 可能变成了新的一级列表，或者与项目 A 断开）
解决方案： 如果希望段落属于列表项，你需要给段落也加上缩进。
- 项目 A
这是一个属于项目 A 的段落描述。它和上面的列表项属于同一层级。
- 项目 B
2. 空行导致的列表中断
在大多数 Markdown 解析器中，列表项之间如果有空行，可能会被视为新的列表开始，或者导致列表样式重置（尤其是有序列表）。
1. 第一项
2. 第二项
这通常没问题，但如果嵌套列表中出现空行，风险很大：
1. 第一项
- 子项 A
- 子项 B
这里的空行可能导致 子项 B 被识别为新的顶级列表项，而不是 第一项 下的子项。
解决方案： 尽量保持列表紧凑，避免在嵌套列表中使用空行。如果必须分段，使用 HTML 的 <br> 标签或者确保缩进一致。
3. 特殊字符在列表中的表现
列表符号 -、*、+ 以及 1. 是 Markdown 的保留字符。如果你想在列表项中显示这些字符本身，而不是让它们成为列表标记，你需要转义它们。
- 这是一个减号: \-
- 这是一个星号: \*
- 这是一个加点: \1.
如果不加反斜杠 \，渲染器可能会误判。例如，输入 - * 可能会被解析为一个嵌套的无序列表项。
给你的实战小练习
光说不练假把式。现在，请你尝试创建一个这样的文档结构：
- 一个三级标题：“我的爱好”
- 一个无序列表，包含三个主要爱好：阅读、编程、旅行。
- 在“编程”下，嵌套一个有序列表，列出你最近学习的三个语言：Python, JavaScript, Go。
- 在“Go”下面，再嵌套一个无序列表，列出 Go 的两个优点：并发支持好、编译速度快。
- 最后，在“旅行”下面，插入一个代码块，展示一段简单的旅行预算计算公式（伪代码即可）。
试着在任意 Markdown 编辑器中输入，看看效果。如果遇到困难，回头检查一下缩进是不是 4 个空格，连字符后面有没有空格。
结语：习惯成自然
Markdown 列表嵌套看似简单，实则考验的是你对层级结构的理解。一旦你掌握了“4 个空格一层级”、“连字符后必跟空格”、“代码块需额外缩进”这几个核心原则，你就能游刃有余地处理任何复杂的文档结构。
别怕犯错，排版工具的魅力就在于即时反馈。多试几次，你的眼睛会慢慢形成肌肉记忆。下次当你看到一篇结构清晰、排版优美的技术文档时，不妨想想，那背后可能就是一个细心的人，耐心地敲下了每一个空格。
希望这篇指南能帮你避开那些烦人的排版坑。如果有其他 Markdown 相关的问题，随时来找我聊。毕竟，让文字清晰表达，是一件很有成就感的事，对吧？