domain: markdown
第 03 节:列表:整理要点和步骤
本节 objectives:
- 能用
-、*或+写出无序列表,并知道同一列表内不要混用符号。- 能用数字加句点写出有序列表,理解渲染器会自动重新编号。
- 能用缩进写出嵌套的子列表(列表里再套一层列表)。
先修:会写强调文字(第 02 节) | 上一节 << 02 强调文字 | 下一节 04 链接与图片 >>
一份购物清单和一份操作步骤,该用哪种列表?
想象你要写两样东西:一份"买菜清单"(牛奶、鸡蛋、面包,谁先谁后无所谓),和一份"泡面步骤"(先烧水、再放面饼、最后加调料——顺序错了会影响结果)。这两种清单在 Markdown 里对应两种不同的列表语法,用错了虽然不会报错,但会让读者误以为"顺序很重要"或者"顺序不重要",产生误导。
这一节教你怎么根据内容本身"要不要讲顺序",选对列表类型。
讲解
无序列表(Unordered list):每一项前面加一个 -、* 或 +,再加一个空格,渲染后会显示成项目符号(通常是圆点),表示这些项之间没有先后顺序1:
同一个列表里要用同一种符号,不要这一项用 -、下一项用 *,混用容易让渲染器把它们拆成两个独立的列表,看起来像中间断开了1。
有序列表(Ordered list):每一项前面写数字加英文句点,再加一个空格。渲染后会自动按顺序显示编号,你写的数字甚至不需要真的按 1、2、3 排列——只要第一项是 1,渲染器就会自动重新编号1:
这一点常让新手意外:如果你写 1. 1. 1.,大多数渲染器依然会显示成 1. 2. 3.,因为它只看"这是不是有序列表",不逐字信任你写的数字。
嵌套列表(子列表):如果某一项底下还需要更细的子项,在子项前面加四个空格的缩进,再写列表符号1:
嵌套列表可以无序套有序,也可以有序套无序,缩进的空格数量是关键——缩进不够,渲染器会把子项当成同一级的新列表项,而不是"挂"在上一项底下。
跟我做一遍(worked example)
在编辑器里敲下面这段,观察无序、有序、嵌套三种效果:
观察要点:"今天要做的事"是圆点列表,没有编号,说明顺序不重要;"写周报的步骤"是数字列表,说明有先后顺序;"填写完成的任务"底下缩进的两条是子列表,视觉上明显往右缩进了一截,表示它们从属于"填写完成的任务"这一步,而不是和"发给主管"平级。
换你补全(faded example)
下面是一份"整理房间"的清单草稿,作者想表达:"整体是有顺序的三个大步骤(先收拾书桌、再整理衣柜、最后打扫地面),第一步底下还有两条不分先后的子任务",但列表符号还没写:
提示:大步骤要"有顺序"用什么列表,子任务"不分先后"用什么列表,子任务前面要不要缩进。
答案:
(大步骤是有序列表,用数字加句点;子任务不分先后,用无序列表的 -;子任务前面需要缩进,表示它们属于"收拾书桌"这一步。)
小结 + 通向下一节
这一节你学会了根据内容"要不要讲顺序"选无序或有序列表,还学了用缩进做嵌套子列表。列表帮你整理"多个平行的信息点";下一节你会学怎么把文字变成一个可点击的跳转入口,或者插入一张图片——这是让笔记连接到外部世界的方式。
Footnotes
-
Basic Syntax | Markdown Guide — https://www.markdownguide.org/basic-syntax/ ↩ ↩2 ↩3 ↩4
Exercises
- 做法指引:在你的编辑器里写一份"这周要完成的三件大事",用有序列表;其中至少一件大事底下有两条无序的子任务。
- 做法指引:故意把一份有序列表的数字全部写成
1.(比如1. 第一步、1. 第二步、1. 第三步),观察预览里渲染出来的编号是什么。