Markdown列表语法
可以将多个条目组织成有序或无序列表。
有序列表
要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。
| Markdown | 语法HTML | 预览效果 |
|---|---|---|
| 1. First item 2. Second item 3. Third item 4. Fourth item |
<ol> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ol> |
|
| 1. First item 1. Second item 1. Third item 1. Fourth item |
<ol> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ol> |
|
| 1. First item 5. Second item 9. Third item 0. Fourth item |
<ol> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ol> |
|
| 1. First item 2. Second item 3. Third item 1. Indented item 2. Indented item 4. Fourth item |
<ol> <li>First item</li> <li>Second item</li> <li>Third item <ol> <li>Indented item</li> <li>Indented item</li> </ol> </il> <li>Fourth item</li> </ol> |
|
使用有序列表的最佳方法
普通标记和其他一些轻量级标记语言允许您使用括号（ ) ）半角符号，作为划界器（例如：1) First item ), ，但并非所有 Markdown 应用程序都支持这一点，因此从兼容性的角度来看，这不是一个好的选择。所以应当只使用（ . ）
| ❌Don’t do this | ⭕Do this |
|---|---|
| 1) First item 2) Second item |
1. First item 2. Second item |
无序列表
要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
| Markdown | 语法HTML | 预览效果 |
|---|---|---|
| - First item - Second item - Third item - Fourth item |
<ul> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ul> |
|
| * First item * Second item * Third item * Fourth item |
<ul> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ul> |
|
| + First item + Second item + Third item + Fourth item |
<ul> <li>First item</li> <li>Second item</li> <li>Third item</li> <li>Fourth item</li> </ul> |
|
| - First item - Second item - Third item - Indented item - Indented item - Fourth item |
<ul> <li>First item</li> <li>Second item</li> <li>Third item <ul> <li>Indented item</li> <li>Indented item</li> </ul> </il> <li>Fourth item</li> </ul> |
|
无序列表的最佳用法
标记应用程序在如何处理同一列表中的不同划界符上标准不一。为了兼容性，不要混合使用同一列表中的划界符。选择一个你喜欢的，然后只用它。
| ❌Don’t do this | ⭕Do this |
|---|---|
| + First item * Second item - Third item + Fourth item |
- First item - Second item - Third item - Fourth item |
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符，如下例所示：
段落
* This is the first list item.
* Here's the second list item.
I need to add another paragraph below the second list item.
* And here's the third list item.
渲染效果如下：
-
This is the first list item.
-
Here’s the second list item.
I need to add another paragraph below the second list item.
-
And here’s the third list item.
引用块
* This is the first list item.
* Here's the second list item.
> A blockquote would look great below the second list item.
* And here's the third list item.
渲染效果如下：
-
This is the first list item.
-
Here’s the second list item.
A blockquote would look great below the second list item.
-
And here’s the third list item.
代码块
代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时，请将它们缩进八个空格或两个制表符。
1. Open the file.
2. Find the following code block on line 21:
<html>
<head>
<title>Test</title>
</head>
3. Update the title to match the name of your website.
渲染效果如下：
-
Open the file.
-
Find the following code block on line 21:
<html> <head> <title>Test</title> </head> -
Update the title to match the name of your website.
图片
1. Open the file containing the Linux mascot.
2. Marvel at its beauty.
<img src="https://i.loli.net/2021/08/15/uJG3mqFvDBbiAdt.png" height="100" width="70">
3. Close the file.
渲染效果如下：
-
Open the file containing the Linux mascot.
-
Marvel at its beauty.
-
Close the file.
列表
可以在有序列表中嵌套无序列表，反之亦然。
1. First item
2. Second item
3. Third item
- Indented item
- Indented item
4. Fourth item
渲染效果如下：
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item