Markdown 列表的详细使用

Markdown 列表 👈点击这里也可查看

1. 前言

关于列表，Markdown作者给出了如下定义：

中文解释：Markdown 支持有序和无序两种列表，无序列表使用 「星号 *」、「加号 +」、「减号 -」表示，有序列表使用数字定义，如: 1. xxx 2.xxx 3.xxx 等。

列表是一种将同类内容进行结构化编排输出的显示方式。列表分为有序列表和无序列表，单级列表和多级列表。

2. 语法详解

2.1 无序列表

在Markdown文件中，我们可以通过*、+、-，三种方式定义无序列表，这三种方式的发布后的效果一样，都会被转换成：

<ul>
<li></li>
</ul>

实例一：
无序列表
代码：

### 无序列表

使用星号生成无序列表

\* 项目1
\* 项目2
\* 项目3

使用加号生成无序列表

+ 项目1
+ 项目2
+ 项目3

使用减号生成无序列表

- 项目1
- 项目2
- 项目3

渲染：
无序列表
使用星号生成无序列表

• 项目1
• 项目2
• 项目3

使用加号生成无序列表

• 项目1
• 项目2
• 项目3

使用减号生成无序列表

• 项目1
• 项目2
• 项目3

2.2 无序列表

在 Markdown 文件中，通过「数字 + 」的形式定义有序列表，有序列表在发布后会被转化为：

<ol>
  <li></li>
</ol>

实例二：
有序列表
代码：

### 有序列表

使用数字实现有序列表

1. 项目1
2. 项目2
3. 项目3

源码中的数字与渲染后的数字并不一一对应，但可以决定列表的开始序号

例如，让 Markdown 渲染器自动安排序号：

0. 项目1
0. 项目2
0. 项目3

让有序列表以 “2” 开头：

2. 项目1
1. 项目2
0. 项目3

渲染：
有序列表

使用数字实现有序列表

1. 项目1
2. 项目2
3. 项目3

源码中的数字与渲染后的数字并不一一对应，但可以决定列表的开始序号

例如，让 Markdown 渲染器自动安排序号：

0. 项目1
1. 项目2
2. 项目3

让有序列表以 “2” 开头：

2. 项目1
3. 项目2
4. 项目3

2.3 列表的嵌套

Markdown 文件的列表支持多层嵌套，即每个列表里面允许增加下级列表，而且这个层级并没有限制。
实例三：
无序列表嵌套无序列表
代码：

* 项目 1
  * 项目 1-1
* 项目2
  * 项目 2-1
  * 项目 2-2
* 项目3

无序列表的嵌套是没有层数限制的

* 第一层 1
  * 第二层 1
    * 第三层 1
      * 第四层 1
        * 第五层 1
    * 第三层 2
 * 第二层 2

2.4

渲染：
无序列表可以通过缩进实现嵌套

• 项目 1
  • 项目 1-1
• 项目2
  • 项目 2-1
  • 项目 2-2
• 项目3

无序列表的嵌套是没有层数限制的

• 第一层 1
  • 第二层 1
    • 第三层 1
      • 第四层 1
        • 第五层 1
    • 第三层 2
• 第二层 2
  实例四：
  有序列表嵌套有序列表
  代码：

有序列表的嵌套

有序列表可以通过缩进实现嵌套

1. 项目 1
   1. 项目 1-1
1. 项目 2
   1. 项目 2-1
   1. 项目 2-2
1. 项目 3

无序列表的嵌套是没有层数限制的

1. 第一层 1
   1. 第二层 1
      1. 第三层 1
         1. 第四层 1
            2. 第五层 1
      3. 第三层 2
     1. 第二层 2

渲染：
有序列表的嵌套

有序列表可以通过缩进实现嵌套

1. 项目 1
   1. 项目 1-1
2. 项目 2
   1. 项目 2-1
   2. 项目 2-2
3. 项目 3

有序列表的嵌套是没有层数限制的

1. 第一层 1
   1. 第二层 1
      1. 第三层 1
         1. 第四层 1
            2. 第五层 1
      2. 第三层 2
   2. 第二层 2

实例五：
有序列表和无序列表的混合嵌套
代码：

有序列表和无序列表混合嵌套
* 无序项目1-1
  1. 有序项目2-1
  1. 有序项目2-2
     + 无序项目3-1
     + 无序项目3-1
   1. 有序项目2-3

渲染：
有序列表和无序列表混合嵌套

• 无序项目1-1
  1. 有序项目2-1
  2. 有序项目2-2
     • 无序项目3-1
     • 无序项目3-1
  3. 有序项目2-3

实例六：
在列表中嵌套其他内容
代码：

列表中嵌套其他内容

段落、图片、引用等内容可以通过缩进的方式进入到列表的结构中。

* 带段落的列表项

  在列表项中的段落
  * 带段落的列表项

    在列表项中的段落

* 带图片的列表项
![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/dcccdf6feb664b7fbf4f174a5d30de81.png =600x60)
  * 带图片的列表项

 ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/dcccdf6feb664b7fbf4f174a5d30de81.png =600x60)

* 带引用的列表项

  > 引用内容
  * 带引用的列表项

    > 引用内容

渲染：
列表中嵌套其他内容

段落、图片、引用等内容可以通过缩进的方式进入到列表的结构中。

• 带段落的列表项

  在列表项中的段落

  • 带段落的列表项

    在列表项中的段落

• 带图片的列表项
  

  • 带图片的列表项

• 带引用的列表项

  引用内容

  • 带引用的列表项

    引用内容

3. 使用场景及实例

列表的作用是有条理的显示内容，是一种非常方便的布局形式。

在一篇文章中，通常会用多级有序列表的方式来呈现文章的目录结构。通常会用无序列表呈现没有明显级别关系的分类，例如菜单项等。
实例七：
代码：

如何制作一杯咖啡

拿铁咖啡是意大利浓缩咖啡与牛奶的经典混合。  
炎炎夏日，来一杯冰咖啡不仅可以提神醒脑，更是身心的一种享受。

用料

+ 主料
  - 咖啡粉
  - 牛奶
+ 辅料
  - 白砂糖
  - 热水一杯

做法

1. 准备好材料
2. 把咖啡粉和热水冲在一起搅和
3. 把牛奶放进盘里用手动打蛋器打。记住！要一直打，打出细腻的奶泡。
4. 把打好的奶泡放入咖啡中，奶泡浮在上面就可以了。

渲染：
如何制作一杯咖啡

拿铁咖啡是意大利浓缩咖啡与牛奶的经典混合。
炎炎夏日，来一杯冰咖啡不仅可以提神醒脑，更是身心的一种享受。

用料

• 主料
  • 咖啡粉
  • 牛奶
• 辅料
  • 白砂糖
  • 热水一杯

做法

1. 准备好材料
2. 把咖啡粉和热水冲在一起搅和
3. 把牛奶放进盘里用手动打蛋器打。记住！要一直打，打出细腻的奶泡。
4. 把打好的奶泡放入咖啡中，奶泡浮在上面就可以了。

4. 小结

如果对您有帮助，请您点赞、收藏、关注、转发，让更多的人看到。

5. 其他文章

Markdown文章集合
👉Markdown分割线的渲染
👉Markdown 引用的用法
👉Markdown 列表的详细使用
👉Markdown综合实例
👉Markdown 生成目录
👉Markdown 分级标题
👉Markdown 脚注尾注
👉Markdown数学公式
👉Markdown 上标、下标的使用
👉Markdown中图片设置属性[尺寸，对齐，格式]
👉Markdown如何实现页内跳转
👉Markdown 中饼图如何使用
👉Markdown中甘特图的使用
👉Markdown中状态图的用法
👉Markdown时序图的使用方法
👉Markdown中类图的用法
👉Markdown中流程图的用法
👉Markdown表格的使用
👉Markdown如何导出Html文件Markdown文件
👉Markdown是什么？.md文件是什么？
👉Markdown段落的空行缩进用法
👉Markdown表格的使用
👉Markdown语法字体字号讲解
👉Markdown如何填充前景色、背景色
👉Markdown代码块，超链接，图片的插入
👉Markdown如何添加任务列表-复选框的添加
👉Markdown中特殊符号的使用
👉Markdown实现代码高亮，注释代码
👉Markdown注释的用法

快来试试吧😊