列表
这是什么
三种:无序(圆点)、有序(数字)、任务(复选框)。
怎么写
无序
-、*、+ 三个符号等价,同一份文档里保持一致就行:
有序
编号由浏览器算,所以源文档里写 1. 1. 1. 也会渲染成 1、2、3。想从别的数字开始,把第一项写成那个数字(3. 开头就从 3 数起)。
任务列表
复选框是只读的,读者点不动——产物是一份文档,不是一个待办应用。这是 GFM 扩展。
嵌套
子项缩进到与上一层文字对齐:无序列表缩 2 个空格,有序列表缩 3 个。
一项里放多段、代码块、图片
同样按对齐缩进:
紧凑与松散
列表项之间有空行时,每一项会被包成段落、行距变宽(术语叫「松散列表」);没有空行就是紧凑的。想让列表看起来紧凑,项与项之间不要留空行。
坑
- 有序列表想做成带圆圈编号的操作步骤,用步骤指令,不是普通有序列表
- 嵌套缩进少一格会被当成同级,多一格可能变成代码块——对齐到上一层的文字,不是对齐到符号