Markdown 语法 · 列表
Markdown 列表怎么写？
无序、有序、嵌套、任务清单
Markdown 列表就是每行开头一个标记加空格:短横做项目符号,数字加点做有序列表。缩进做嵌套,加方括号做清单。
AI 回答特别爱用列表,你会读到、改到不少。这篇讲清无序、有序、嵌套、任务列表——以及哪些小错会让列表不渲染。
还没搞懂整体语法?先看 Markdown 怎么写。
四种列表
| 类型 | 写法 | 说明 |
|---|---|---|
| 无序（项目符号） | 短横加空格：- 项目 | 星号（*）或加号（+）也行——保持一致 |
| 有序（数字） | 数字、点、空格：1. 项目 | 自动重新编号；1. 1. 1. 也显示 1、2、3 |
| 嵌套 | 把子项缩进到父项下 | 缩进宽度保持一致 |
| 任务清单（复选框） | - [ ] 待办 和 - [x] 已完成 | GFM 扩展；渲染成复选框 |
合起来:
无序——短横加空格：
- 第一项
- 第二项
- 嵌套项（缩进）
有序——数字、点、空格：
1. 第一
2. 第二
任务清单——复选框（GFM）：
- [ ] 待办的事
- [x] 已完成的事项目符号 vs 数字 vs 嵌套
- 项目符号:短横加空格。喜欢用
*或+也行——只是别在一个列表中途换标记。 - 数字:数字、点、空格。数字不用连续;渲染器会重编号,所以每行都写
1.也没问题。 - 嵌套:把子项缩进到父项下,整段缩进宽度保持一致——嵌套显示不对,通常就是缩进不一致。
任务清单（复选框）
在项目符号后加方括号:- [ ] 未勾选、- [x] 已勾选。这是 GitHub 风格 Markdown 的扩展,在支持 GFM 的地方渲染成复选框——记待办很顺手。
Markdown 列表为什么不渲染
| 症状 | 怎么回事 | 怎么修 |
|---|---|---|
| 列表显示成纯文字 | 标记后面没空格（-项目） | 加上空格：- 项目 |
| 嵌套显示不对 | 子项缩进不一致 | 整个列表用相同的缩进宽度 |
| 列表和段落连在一起 | 列表前没空行 | 段落和列表之间空一行 |
| 数字不重新编号 | 渲染器差异 | 关键是 1. 的格式、不是数字本身——不重编就查你的渲染器 |
头号原因:标记后面漏了空格。是 - 项目,不是 -项目——1. 项目 同理。
用 NoteLoom 读写列表
NoteLoom 是个在浏览器里读写本地 .md 文件的编辑器。它的 reading 和 live 视图把无序、有序、嵌套、任务列表都渲染出来——让你看清结构而不是数短横——你在 source 视图里写和改,直接存回本地文件。
先说清边界:NoteLoom 没有任何 AI——不会替你写列表项、把段落变成列表。它只打开、显示、存回你的 Markdown;内容是你自己的。
用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc → 挂载一个本地文件夹 → 打开 .md → 在 source 里写列表、在 live 里看 → 存回本地,不上云、不用账号。
FAQ
Markdown 里怎么写无序列表？
每行以短横加一个空格开头：- 项目。星号（*）和加号（+）也行——挑一个用到底。标记后面那个空格是必须的；-项目 没空格不会渲染成列表。
怎么写有序列表？
每行以数字、点、空格开头：1. 项目。数字其实不用对——大多数渲染器会自动重新编号，你写 1. 1. 1. 照样得到 1、2、3。保持"数字点空格"的格式就行。
怎么嵌套列表？
把子项缩进到父项下面——常见是两个空格（有的渲染器要子项对齐到父项文字下）。同一列表里缩进宽度保持一致；嵌套显示不对，多半是缩进不一致。
怎么做清单 / 任务列表？
用 GFM 任务列表语法：- [ ] 是未勾选、- [x] 是已勾选。在支持 GitHub 风格 Markdown 的工具里会渲染成复选框。NoteLoom 支持 GFM，所以任务列表在它里面能渲染。
我的 Markdown 列表为什么不渲染？
最常见：标记后面没空格（要写 - 项目，不是 -项目）；嵌套项缩进不一致；或列表前缺一个空行（有的渲染器要求段落和列表之间空一行）。先查这三样。
NoteLoom 能帮我处理列表吗？
NoteLoom 打开你本地的 .md，在 reading 和 live 视图里把无序、有序、嵌套、任务列表都渲染出来，让你看清结构而不是数短横——你在 source 视图里写和改。它没有任何 AI：不会替你生成列表内容，只显示和存回你本地的 Markdown。
手机或 Safari 能用 NoteLoom 弄吗？
目前不行。NoteLoom 依赖浏览器的 File System Access API，当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器；Firefox、Safari 和手机端暂不支持。
看清列表,别数短横
用 Chrome / Edge / Arc 打开 NoteLoom,挂载一个本地文件夹,在 source 视图里写列表——reading 和 live 视图显示出结构、复选框都在。直接存回本地,不用装软件,也不用注册账号。
打开 NoteLoom 试试