Markdown 基础语法:零基础入门 · 第 3 / 6 节

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

  1. Basic Syntax | Markdown Guide — https://www.markdownguide.org/basic-syntax/ 2 3 4

Exercises

Exercise 1 · Level 1:写一份带子任务的待办清单
  • 做法指引:在你的编辑器里写一份"这周要完成的三件大事",用有序列表;其中至少一件大事底下有两条无序的子任务。
Done criteria · checked locally
Exercise 2 · Level 2:验证"数字不用写对"的特性
  • 做法指引:故意把一份有序列表的数字全部写成 1.(比如 1. 第一步1. 第二步1. 第三步),观察预览里渲染出来的编号是什么。
Done criteria · checked locally