概述
有序列表用来对一系列条目进行编号显示。除了常规的编号功能外,小书匠还提供了起始编号值设定功能。
使用
默认有序列表
直接在每个条目上进行数值编号
示例
- 11. 条目一
- 22. 条目二
- 33. 条目三
效果
- 条目一
- 条目二
- 条目三
自动有序列表编号
如果在同一个段落的多个条目里,编号值不是顺序的,系统也会自动纠正成顺序的数字编号,并以第一个条目的编号值做为起始值
示例
- 11. 条目一
- 21. 条目二
- 33. 条目三
效果
- 条目一
- 条目二
- 条目三
指定有序列表起始编号值
在同一个段落的多个条目里,可以对第一个编号值指定数值大小,生成的文档将按照该值进行编号
示例
- 15. 条目一
- 21. 条目二
- 33. 条目三
效果
- 条目一
- 条目二
- 条目三
嵌套有序列表
通过间隔二个以上的空隔,可以实现多级嵌套有序列表功能。
示例
- 11. 条目一
- 2 1. 子条目一
- 3 2. 子条目二
- 42. 条目二
单条目多行
列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
要让列表看起来更漂亮,你可以把内容用固定的缩进整理好:
- 11. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
- 2 Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
- 3 viverra nec, fringilla in, laoreet vitae, risus.
- 42. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
- 5 Suspendisse id sem consectetuer libero luctus adipiscing.
或者也可以写成这样
- 11. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
- 2Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
- 3viverra nec, fringilla in, laoreet vitae, risus.
- 42. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
- 5Suspendisse id sem consectetuer libero luctus adipiscing.
显示效果
- 条目一
- 子条目一
- 子条目二
- 条目二
HTML
像下面的有序列表
- 11. Bird
- 22. McHale
- 33. Parish
生成对应的 HTML 结构为
- 1<ol>
- 2<li>Bird</li>
- 3<li>McHale</li>
- 4<li>Parish</li>
- 5</ol>
如果指定了起始编辑
- 14. Bird
- 22. McHale
- 33. Parish
生成对应的 HTML 结构为
- 1<ol start="4">
- 2<li>
- 3Bird</li>
- 4<li>
- 5McHale</li>
- 6<li>
- 7Parish</li>
- 8</ol>
如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p>
标签包起来, 比如:
- 11. Bird
- 2
- 32. McHale
生成对应的 HTM 为:
- 1<ol>
- 2<li>
- 3<p>Bird</p>
- 4</li>
- 5<li>
- 6<p>McHale</p>
- 7</li>
- 8</ol>
有序列表与其他语法的使用
列表项目多段落
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
- 11. This is a list item with two paragraphs. Lorem ipsum dolor
- 2 sit amet, consectetuer adipiscing elit. Aliquam hendrerit
- 3 mi posuere lectus.
- 4
- 5 Vestibulum enim wisi, viverra nec, fringilla in, laoreet
- 6 vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
- 7 sit amet velit.
- 8
- 92. Suspendisse id sem consectetuer libero luctus adipiscing.
- 10
如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许:
- 11. This is a list item with two paragraphs.
- 2
- 3 This is the second paragraph in the list item. You're
- 4only required to indent the first line. Lorem ipsum dolor
- 5sit amet, consectetuer adipiscing elit.
- 6
- 72. Another item in the same list.
列表和引用
如果要在列表项目内放进引用,那 >
就需要缩进
- 11. A list item with a blockquote:
- 2
- 3 > This is a blockquote
- 4 > inside a list item.
列表和代码块
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
- 11. 一列表项包含一个列表区块:
- 2
- 3 <代码写在这>
或者
- 11. 一列表项包含一个列表区块:
- 2 ``` javascript
- 3 var x = 1;
- 4 ```
显示效果
- 一列表项包含一个列表区块:
- 1 var x = 1;
- 1 var x = 1;
疑问
当然,项目列表很可能会不小心产生,像是下面这样的写法
- 11986. What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
- 11986\. What a great season.