嘿，朋友！你是不是也遇到过这种情况：兴冲冲地写了一篇Markdown笔记，结果渲染出来的列表乱七八糟，缩进对不上，甚至有的浏览器直接显示代码而不显示列表？别急，这真的是新手（包括我曾经）最容易踩坑的地方。
今天我们就把这个问题彻底讲清楚，从“为什么错”到“怎么写对”，再到“怎么测试”，让你以后写嵌套列表再也不头疼。
为什么嵌套列表总出错？
Markdown 的核心逻辑是缩进表示层级。但问题在于：
- 空格还是Tab？ 有些编辑器默认用Tab，有些用空格，渲染器可能不吃Tab。
- 缩进几个字符？ 标准是2个空格或4个空格，但很多新手直接按一次Tab或者随便敲几个空格。
- 列表类型混用？ 无序列表嵌套有序列表，或者反过来，格式要求更严格。
- 行首空格被吃掉？ 有些Markdown编辑器会自动清理行首空格，导致缩进失效。
别慌，接下来我们逐个击破。
一、基础规则：缩进是王道
在Markdown中，嵌套的列表项必须比父级列表项多出至少2个空格（推荐4个空格）的缩进。
1.1 无序列表嵌套无序列表
这是最简单的情况。
❌ 错误写法：
- 一级项
- 二级项
- 三级项
预览效果：
- 一级项
- 二级项
- 三级项
问题： 三级项前面只有一个缩进（可能是Tab或2空格），但有些渲染器认为2空格不够清晰，或者和二级项的缩进混淆。虽然很多渲染器能识别，但不稳定。
✅ 正确写法（推荐4空格缩进）：
- 一级项
- 二级项
- 三级项
预览效果：
- 一级项
- 二级项
- 三级项
- 二级项
解释： 每级多4个空格，层级清晰，所有渲染器都能正确识别。
1.2 有序列表嵌套有序列表
❌ 错误写法：
1. 第一项
2. 第二项
1. 子项A
2. 子项B
预览效果：
- 第一项
- 第二项
- 子项A
- 子项B
问题： 子项A和子项B的缩进可能不统一，或者渲染器认为2.后面的空格不够，导致子项变成新的顶级列表。
✅ 正确写法：
1. 第一项
2. 第二项
1. 子项A
2. 子项B
预览效果：
- 第一项
- 第二项
- 子项A
- 子项B
解释： 子项比父项多4个空格（包括数字和点后面的空格），这样层级明确。
1.3 无序列表嵌套有序列表
❌ 错误写法：
- 水果
- 蔬菜
1. 菠菜
2. 白菜
预览效果：
- 水果
- 蔬菜
- 菠菜
- 白菜
问题： 看起来没问题，但有些渲染器会把有序列表的缩进和前面的短横线对齐，导致错位。
✅ 正确写法：
- 水果
- 蔬菜
1. 菠菜
2. 白菜
预览效果：
- 水果
- 蔬菜
- 菠菜
- 白菜
解释： 有序列表子项比无序父项多4个空格，确保对齐清晰。
1.4 有序列表嵌套无序列表
❌ 错误写法：
1. 步骤一
2. 步骤二
- 子步骤A
- 子步骤B
预览效果：
- 步骤一
- 步骤二
- 子步骤A
- 子步骤B
问题： 可能渲染成：
- 步骤一
- 步骤二
- 子步骤A
- 子步骤B
解释： 缩进不够，导致子列表被当成顶级列表。
✅ 正确写法：
1. 步骤一
2. 步骤二
- 子步骤A
- 子步骤B
预览效果：
- 步骤一
- 步骤二
- 子步骤A
- 子步骤B
解释： 无序子项比有序父项多4个空格。
二、进阶技巧：复杂嵌套和特殊场景
2.1 多层嵌套（3层以上）
很多新手写到第三层就乱了。记住：每层多加4个空格。
✅ 正确写法：
- 第一层
- 第二层
- 第三层
- 第四层
预览效果：
- 第一层
- 第二层
- 第三层
- 第四层
- 第三层
- 第二层
2.2 列表中间插入段落或代码块
这是最容易出错的地方！如果你想在列表项中间插入一段话或代码，必须保持缩进。
❌ 错误写法：
- 第一项
普通段落
- 子项
预览效果：
- 第一项 普通段落
- 子项
问题： 普通段落破坏了列表结构。
✅ 正确写法（使用4空格缩进包裹段落）：
- 第一项
普通段落
- 子项
预览效果：
- 第一项
普通段落
- 子项
解释： 段落必须缩进4个空格（相对于列表标记），这样渲染器会认为它属于列表项的一部分。
代码块同理：
- 使用git
```bash
git status
```
- 提交代码
预览效果：
- 使用git
git status- 提交代码
2.3 有序列表从特定数字开始
如果你需要有序列表从某个数字开始，并且嵌套子列表，写法如下：
3. 第三步
1. 子步骤一
2. 子步骤二
注意： 子步骤的缩进依然要4个空格。
三、一键检测：如何快速验证你的列表是否正确？
与其瞎猜，不如用工具测试。以下是几种方法：
方法1：使用在线Markdown预览器
推荐几个好用的在线工具：
- StackEdit（功能强大，支持实时预览）
- Dillinger（简洁直观）
- Markdown Live Preview（实时对比）
把代码粘贴进去，右侧立即显示效果，不对就改，直到正确为止。
方法2：VS Code内置预览
如果你用VS Code写Markdown，按 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（Mac）可以打开预览窗口，实时查看效果。
方法3：用Python脚本自动检查缩进
对于经常写复杂列表的人，可以写一个简单的脚本来高亮缩进问题。例如：
import re
def check_list_indent(text):
lines = text.split('\n')
errors = []
for i, line in enumerate(lines):
# 匹配列表项
if re.match(r'^(\s*)[-*+]\s', line) or re.match(r'^(\s*)\d+\.\s', line):
indent = len(line) - len(line.lstrip())
# 检查缩进是否是4的倍数（推荐）
if indent % 4 != 0:
errors.append(f"第{i+1}行缩进不是4的倍数: {line!r}")
# 检查段落是否在列表内但缩进不足
elif line.strip() and not re.match(r'^\s*```', line) and not re.match(r'^\s*[-*+]\s', line) and not re.match(r'^\s*\d+\.\s', line):
# 可能是段落，检查前一行是否是列表项
if i > 0 and re.match(r'^[-*+]|\d+\.', lines[i-1]):
errors.append(f"第{i+1}行可能是列表内的段落，但缩进可能不足: {line!r}")
return errors
# 测试文本
md_text = """
- 第一层
- 第二层
- 第三层
- 错误缩进
普通段落
- 另一项
"""
print(check_list_indent(md_text))
输出示例：
['第5行缩进不是4的倍数: " - 错误缩进"', '第6行可能是列表内的段落，但缩进可能不足: " 普通段落"']
这个脚本很简单，但能帮你快速定位缩进问题。
四、常见错误总结表
为了让你更直观地理解，我整理了一个对比表：
| 场景 | 错误写法 | 正确写法 | 问题原因 |
|---|---|---|---|
| 无序嵌套无序 | - item |
- item |
缩进不足2空格 |
| 有序嵌套有序 | 1. sub |
1. sub |
缩进不足，可能被当成新列表 |
| 无序嵌套有序 | 1. sub |
1. sub |
对齐混乱 |
| 有序嵌套无序 | - sub |
- sub |
子项变成顶级 |
| 列表内段落 | paragraph |
paragraph |
段落破坏列表结构 |
| 列表内代码块 | code |
code |
代码块缩进不足 |
五、给小朋友的比喻
想象你在玩积木塔：
- 第一层积木是
- 第一层 - 第二层积木要放在第一层上面，所以你必须向右挪4格再放
- 第二层 - 第三层积木要放在第二层上面，再向右挪4格放
- 第三层
如果你直接放在第一层旁边（不缩进），它就变成另一个塔了，而不是叠在第一层上面。
段落在列表里就像夹心饼干，必须被列表的“面包片”（缩进）包着，否则会掉出来。
六、终极建议：养成好习惯
- 统一用4空格缩进，不要用Tab，不要用2空格。
- 写完一个列表，立即预览，不要等写完整个文档再检查。
- 使用支持Markdown预览的编辑器，如VS Code、Typora、Obsidian等。
- 复制粘贴时注意缩进，很多复制的内容会丢失缩进。
结语
嵌套列表是Markdown中最基础但也最容易出错的地方。记住：缩进即层级，4空格最安全。多练习，多预览，你很快就能写出整洁漂亮的列表了。
如果你还有疑问，欢迎在评论区贴出你的代码，我们一起debug！