列表

您可以将项目整理成有序列表和无序列表。

有序列表

要创建有序列表，请在每行项目前添加数字并后跟英文句点。数字不必按数字顺序排列，但列表应该以数字 1 开头。

MarkdownHTML渲染效果
1. 第一项
2. 第二项
3. 第三项
4. 第四项		<ol>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ol>
  1. 第一项
  2. 第二项
  3. 第三项
  4. 第四项
1. 第一项
1. 第二项
1. 第三项
1. 第四项		<ol>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ol>
  1. 第一项
  2. 第二项
  3. 第三项
  4. 第四项
1. 第一项
8. 第二项
3. 第三项
5. 第四项		<ol>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ol>
  1. 第一项
  2. 第二项
  3. 第三项
  4. 第四项
1. 第一项
2. 第二项
3. 第三项
    1. 缩进项
    2. 缩进项
4. 第四项		<ol>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项
    <ol>
      <li>缩进项</li>
      <li>缩进项</li>
    </ol>
  </li>
  <li>第四项</li>
</ol>
  1. 第一项
  2. 第二项
  3. 第三项
    1. 缩进项
    2. 缩进项
  4. 第四项

有序列表最佳实践

CommonMark 和一些其他轻量级标记语言允许您使用括号（)）作为分隔符（例如，1) 第一项），但并非所有 Markdown 应用都支持此用法。为了兼容性，请只使用英文句点。

✅  推荐❌  不推荐
1. 第一项
2. 第二项		1) 第一项
2) 第二项

无序列表

要创建无序列表，请在行项目前添加破折号（-）、星号（*）或加号（+）。缩进一个或多个项目以创建嵌套列表。

MarkdownHTML渲染效果
- 第一项
- 第二项
- 第三项
- 第四项		<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ul>
  • 第一项
  • 第二项
  • 第三项
  • 第四项
* 第一项
* 第二项
* 第三项
* 第四项		<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ul>
  • 第一项
  • 第二项
  • 第三项
  • 第四项
+ 第一项
+ 第二项
+ 第三项
+ 第四项		<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
  <li>第四项</li>
</ul>
  • 第一项
  • 第二项
  • 第三项
  • 第四项
- 第一项
- 第二项
- 第三项
    - 缩进项
    - 缩进项
- 第四项		<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项
    <ul>
      <li>缩进项</li>
      <li>缩进项</li>
    </ul>
  </li>
  <li>第四项</li>
</ul>
  • 第一项
  • 第二项
  • 第三项
    • 缩进项
    • 缩进项
  • 第四项

以数字开头的无序列表项

如果您需要以数字后跟句点开头来开始一个无序列表项，可以使用反斜杠（\）来转义句点。

MarkdownHTML渲染效果
- 1968\. 伟大的一年！
- 我觉得 1969 年是第二好的。		<ul>
  <li>1968. 伟大的一年！</li>
  <li>我觉得 1969 年是第二好的。</li>
</ul>
  • 1968. 伟大的一年！
  • 我觉得 1969 年是第二好的。

无序列表最佳实践

Markdown 应用程序对于同一列表中使用不同分隔符的处理方式不一致。为了兼容性，不要在同一列表中混用分隔符——选择一种并坚持使用。

✅  推荐❌  不推荐
- 第一项
- 第二项
- 第三项
- 第四项		+ 第一项
*  第二项
-  第三项
+ 第四项

在列表中添加元素

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

提示

如果事情没有如你所愿，请再次确认列表中的元素是否缩进了四个空格或一个制表符。

段落

* 这是第一个列表项。
* 这是第二个列表项。

    我需要在第二个列表项下面再添加一个段落。

* 这是第三个列表项。

渲染效果：

  • 这是第一个列表项。

  • 这是第二个列表项。

    我需要在第二个列表项下面再添加一个段落。

  • 这是第三个列表项。

引用块

* 这是第一个列表项。
* 这是第二个列表项。

    > 在第二个列表项下面放一个引用块会很好看。

* 这是第三个列表项。

渲染效果：

  • 这是第一个列表项。

  • 这是第二个列表项。

    在第二个列表项下面放一个引用块会很好看。

  • 这是第三个列表项。

代码块

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

1. 打开文件。
2. 在第 21 行找到以下代码块：

        <html>
          <head>
            <title>测试</title>
          </head>

3. 将标题更新为您的网站名称。

渲染效果：

  1. 打开文件。

  2. 在第 21 行找到以下代码块：

     <html>
   <head>
     <title>测试</title>
   </head>

  3. 将标题更新为您的网站名称。

图片

1. 打开包含 Linux 吉祥物的文件。
2. 欣赏它的美丽。

    ![Tux，Linux 的吉祥物](/assets/images/tux.png)

3. 关闭文件。

渲染效果：

  1. 打开包含 Linux 吉祥物的文件。

  2. 欣赏它的美丽。

    Tux，Linux 的吉祥物

  3. 关闭文件。

嵌套列表

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

1. 第一项
2. 第二项
3. 第三项
    - 缩进项
    - 缩进项
4. 第四项

渲染效果：

  1. 第一项
  2. 第二项
  3. 第三项
    • 缩进项
    • 缩进项
  4. 第四项