Markdown 列表
1. 前言
关于列表,Markdown 作者给出了如下定义:
解释:Markdown 有序和无序两种列表,无序列表使用 「星号 "*"」
、「加号 "+"」
、「减号 "-"」
表示,有序列表使用数字定义,如: 1. xxx 2.xxx 3.xxx
等。
原文出处:。
列表是一种将同类进行结构化编排的方式。列表分为有序列表和无序列表,单级列表和多级列表。
环境说明:
考虑到 Markdown 工具之不兼容,有的直接从复制粘贴到本地不会正常,大家学习时自己动手写是肯定没问题的。本节所有实例及演示均使用 Typora 工具完成。
2. 语法详解
在 Markdown 中,我们可以通过 *
、+
、-
,三种方式定义无序列表,这三种方式的发布后的一样,都会被转换成:
<ul><li></li></ul>
实例 1:
### 无序列表使用星号无序列表* 项目1* 项目2* 项目3 使用加号无序列表+ 项目1+ 项目2+ 项目3 使用减号无序列表- 项目1- 项目2- 项目3
渲染结果如下:
在 Markdown 中,通过「数字 + .
」的形式定义有序列表,有序列表在发布后会被转化为:
<ol> <li></li></ol>
实例 2:
### 有序列表使用数字实现有序列表1. 项目12. 项目23. 项目3 源码中的数字与渲染后的数字并不一一对应,但可以决定列表的开始序号 例如,让 Markdown 渲染器安排序号:0. 项目10. 项目20. 项目3 让有序列表以 “2” 开头:2. 项目11. 项目20. 项目3
其渲染结果如下:
Markdown 的列表多层嵌套,即每个列表里面允许下级列表,而且这个层级并没有限制。
实例 3:
无序列表嵌套无序列表
### 无序列表的嵌套无序列表可以通过缩进实现嵌套* 项目 1 * 项目 1-1* 项目2 * 项目 2-1 * 项目 2-2* 项目3 无序列表的嵌套是没有层数限制的* 第一层 1 * 第二层 1 * 第三层 1 * 第四层 1 * 第五层 1 * 第三层 2 * 第二层 2
其渲染结果如下:
实例 4:
有序列表嵌套有序列表
### 有序列表的嵌套有序列表可以通过缩进实现嵌套1. 项目 1 1. 项目 1-11. 项目 2 1. 项目 2-1 1. 项目 2-21. 项目 3 无序列表的嵌套是没有层数限制的1. 第一层 1 1. 第二层 1 1. 第三层 1 1. 第四层 1 1. 第五层 1 1. 第三层 2 1. 第二层 2
其渲染结果如下:
实例 5:
有序列表和无序列表的混合嵌套
### 有序列表和无序列表混合嵌套* 无序项目1-1 1. 有序项目2-1 1. 有序项目2-2 - 无序项目3-1 - 无序项目3-1 1. 有序项目2-3
渲染结果如下:
实例 6:
在列表中嵌套其他
### 列表中嵌套其他段落、、引用等可以通过缩进的方式进入到列表的结构中。* 带段落的列表项 在列表项中的段落 * 带段落的列表项 在列表项中的段落* 带的列表项 ![](https://www.imooc.com/static/img/index/.png) * 带的列表项 ![](https://www.imooc.com/static/img/index/.png)* 带引用的列表项 > 引用 * 带引用的列表项 > 引用
其渲染结果如下:
3. 使用场景及应用实例
列表的作用是有条理的,是一种非常方便的布局形式。
在一篇中,通常会用多级有序列表的方式来呈现的目录结构。通常会用无序列表呈现没有明显级别关系的,例如项等。
实例 7:
如何用列表展示咖啡的制作说明
### 如何制作一杯咖啡拿铁咖啡是意大利浓缩咖啡与牛奶的经典混合。 炎炎夏日,来一杯冰咖啡不仅可以提神醒脑,更是身心的一种享受。#### 用料+ 主料 - 咖啡粉 - 牛奶+ 辅料 - 白砂糖 - 热水一杯#### 做法1. 准备好材料2. 把咖啡粉和热水冲在一起搅和3. 把牛奶放进盘里用手动打蛋器打。记住!要一直打,打出细腻的奶泡。4. 把打好的奶泡放入咖啡中,奶泡浮在上面就可以了。
其渲染结果如下:
4. 小结
需要注意的是,书写有序列表时,源码中的顺序号并不代表后的序号,如果希望重新定义有序列表的起始数字,需要在两个列表间插入两个空行;
Markdown 的列表分段,即列表项的后续,如果保持了同样的缩进,后续也是划归在列表里的。
列表是中用于呈现观点的很好方式,也是常见的辅助项,例如目录、或者树形、步骤图等。