# 列表

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

# 有序列表

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

Markdown HTML 渲染效果
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) 第二项

# 无序列表

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

Markdown HTML 渲染效果
- 第一项
- 第二项
- 第三项
- 第四项
<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>
  • 第一项
  • 第二项
  • 第三项
    • 缩进项
    • 缩进项
  • 第四项

# 以数字开头的无序列表项

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

Markdown HTML 渲染效果
- 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. 第四项



微信公众号

QQ交流群
原创网站开发,偏差难以避免。

如若发现错误,诚心感谢反馈。

愿你倾心相念,愿你学有所成。

愿你朝华相顾,愿你前程似锦。