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 2. Second item 3. Third item 4. 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>`	1. First item 2. Second item 3. Third item 4. 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>`	1. First item 2. Second item 3. Third item 4. 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>`	1. First item 2. Second item 3. Third item 1. Indented item 2. Indented item 4. Fourth item

有序列表最佳实践

CommonMark 以及其他一些轻量级标记语言允许你使用右括号) 作为分隔符（例如：1) First item），但并非所有 Markdown 应用都支持这种写法，因此从兼容性的角度来看，这并不是一个理想的选择。为了保证兼容性，请只使用句点（.）。

✅ Do this	❌ Don't 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
`* 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` `+ 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 应用在如何处理同一个列表中使用不同分隔符的问题上并不一致。为了兼容性，不要在同一个列表中混合使用多种分隔符——请选择一种，并始终保持一致。

✅ Do this	❌ Don't 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>
```

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.
    ![Tux, the Linux mascot](/assets/images/tux.png)
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