Markdown 教程 - 基本语法 - 列表语法

可以将多个条目组织成有序或无序列表。

一、有序列表

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点.数字不必按数学顺序排列，但是列表应当以数字1起始。

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>

渲染效果：

First item
Second item
Third item
Fourth item

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>

渲染效果：

First item
Second item
Third item
Fourth item

1. First item
8. Second item
3. Third item
5. Fourth item

<ol>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>

渲染效果：

First item
Second item
Third item
Fourth item

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>
</li>
<li>Fourth item</li>
</ol>

渲染效果：

First item
Second item
Third item
1. Indented item
2. Indented item
Fourth item

有序列表最佳实践：
CommonMark 和其他一些轻量级标记语言允许使用括号)作为分隔符（例如，1)第一项），但并非所有 Markdown 应用程序都支持此功能，因此从兼容性角度来看，这不是一个理想的选择。为了保证兼容性，请仅使用句点.。

二、无序列表

要创建无序列表，请在每个列表项前面添加破折号-、星号*或加号+。缩进一个或多个列表项可创建嵌套列表。

- 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

- 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>
</li>
<li>Fourth item</li>
</ul>

渲染效果：

First item
Second item
Third item
- Indented item
- Indented item
Fourth item

无序列表最佳实践：
Markdown 应用对于如何处理同一列表中的不同分隔符并不一致。为了兼容性，请勿在同一列表中混用不同的分隔符——选择一种并坚持使用。

三、在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符，如下例所示：

3.1 段落

*   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.

3.2 引用块

*   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.

3.3代码块

代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时，请将它们缩进八个空格或两个制表符。

1.  Open the file.
2.  Find the following code block on line 21:

        &lt;html>
          &lt;head>
            &lt;title>Test&lt;/title>
          &lt;/head>

3.  Update the title to match the name of your website.

渲染效果：

Open the file.

Find the following code block on line 21:

&lt;html>  
  &lt;head>  
    &lt;title>Test&lt;/title>  
  &lt;/head>

Update the title to match the name of your website.

3.4 图片

1.  Open the file containing the Linux mascot.
2.  Marvel at its beauty.

    ![Tux, the Linux mascot](images/andyiso_com_1.jpg)

3.  Close the file.

渲染效果：

Open the file containing the Linux mascot.
Marvel at its beauty.
Close the file.

3.5 列表

你可以将无序列表嵌套在有序列表中，反之亦然。

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