1. 主页
  2. 文档
  3. 码档 (Markdown)
  4. 基本语法
  5. 码档列表语法

码档列表语法

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

有序列表

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

码档语法预览效果
1. 第一项
2. 第二项
3. 第三项
4. 第四项
1. 第一项
1. 第二项
1. 第三项
1. 第四项
1. 第一项
8. 第二项
3. 第三项
5. 第四项
1. 第一项
2. 第二项
3. 第三项
    1. 缩进项
    2. 缩进项
4. 第四项

有序列表最佳实践

共用标志(CommonMark) 和其他一些轻量级标记语言允许您使用括号 “” 作为分隔符(例如,1) 第一项),但并非所有 码档 应用程序都支持此功能,因此从兼容性的角度来看,这不是一个好的选择。为了兼容,请仅使用句点。

✅  这样子❌  不要这样做
1. 第一项
2. 第二项
1) 第一项
2) 第二项

无序列表

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

码档语法预览效果
- 第一项
- 第二项
- 第三项
- 第四项
* 第一项
* 第二项
* 第三项
* 第四项
+ 第一项
+ 第二项
+ 第三项
+ 第四项
- 第一项
- 第二项
- 第三项
    - 缩进项
    - 缩进项
- 第四项

无序列表最佳实践

码档 应用程序不同意如何处理同一列表中的不同分隔符。为了兼容,不要在同一列表中混合和匹配分隔符 – 选择一个并坚持下去。

✅  这样做❌  不要这样做
- 第一项
- 第二项
- 第三项
- 第四项
+ 第一项
* 第二项
- 第三项
+ 第四项

在列表中嵌套其他元素

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

段落

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

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

* 这是第三个列表项。

渲染效果如下:

引用块

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

    > 块引用在第二个列表项下方看起来很棒。

* 这是第三个列表项。

渲染效果如下:

代码块

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

1.  打开`首页显示.序`文件
2.  在第 12 行找到以下代码块:

        常 首页数据: 型首页数据 = {
          // 标题: "君土展示我",
          // 图片: "https://tva1.sinaimg.cn/large/e6c9d24ely1h4y99eo7wcj20e80e8ta4.jpg",
          码档:
            `# 君土展示我
        ![君土.jpg](https://tva1.sinaimg.cn/large/e6c9d24ely1h4y99eo7wcj20e80e8ta4.jpg)

3.  更改码档的值,设置首页显示内容。

渲染效果如下:

图片

1. 创建项目。
2. 使用母语编程。

    ![母语编程](https://dl.jtu.net.cn/img/biancheng-216x216.png)

3. 关闭文件。

渲染效果如下:

列表

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

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

渲染效果如下:

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