可以将多个条目组织成有序或无序列表。
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
码档语法 | 预览效果 |
---|---|
1. 第一项 | |
1. 第一项 | |
1. 第一项 | |
1. 第一项 |
有序列表最佳实践
共用标志(CommonMark) 和其他一些轻量级标记语言允许您使用括号 “)
” 作为分隔符(例如,1) 第一项),但并非所有 码档 应用程序都支持此功能,因此从兼容性的角度来看,这不是一个好的选择。为了兼容,请仅使用句点。
✅ 这样子 | ❌ 不要这样做 |
---|---|
1. 第一项 | 1) 第一项 |
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
码档语法 | 预览效果 |
---|---|
- 第一项 | |
* 第一项 | |
+ 第一项 | |
- 第一项 |
无序列表最佳实践
码档 应用程序不同意如何处理同一列表中的不同分隔符。为了兼容,不要在同一列表中混合和匹配分隔符 – 选择一个并坚持下去。
✅ 这样做 | ❌ 不要这样做 |
---|---|
- 第一项 | + 第一项 |
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符,如下例所示:
段落
* 这是第一个列表项。
* 这是第二个列表项。
我需要在第二个列表项下面再添加一段。
* 这是第三个列表项。
渲染效果如下:
引用块
* 这是第一个列表项。
* 这是第二个列表项。
> 块引用在第二个列表项下方看起来很棒。
* 这是第三个列表项。
渲染效果如下:
代码块
代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进八个空格或两个制表符。
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. 第四项
渲染效果如下:
- 第一项
- 第二项
- 第三项
- 缩进项
- 缩进项
- 第四项