有序列表 #

概述 #

有序列表用于展示有特定顺序的项目，使用数字进行标记。

基本语法 #

使用数字加点号创建有序列表：

1. 第一项
2. 第二项
3. 第三项

渲染效果：

1. 第一项
2. 第二项
3. 第三项

数字自动修正 #

Markdown 会自动修正列表编号，源码中的数字不必连续：

1. 第一项
1. 第二项
1. 第三项

1. 第一项
5. 第二项
3. 第三项

以上两种写法渲染结果相同：

1. 第一项
2. 第二项
3. 第三项

列表标记格式 #

标准格式 #

1. 项目一
2. 项目二
3. 项目三

简化格式 #

1. 项目一
1. 项目二
1. 项目三

格式对比 #

推荐做法 #

• 简单列表：使用相同数字 1.
• 步骤说明：使用连续数字

列表嵌套 #

基本嵌套 #

1. 第一项
   1. 嵌套项一
   2. 嵌套项二
2. 第二项
   1. 嵌套项一
   2. 嵌套项二

渲染效果：

1. 第一项
   1. 嵌套项一
   2. 嵌套项二
2. 第二项
   1. 嵌套项一
   2. 嵌套项二

混合嵌套 #

1. 有序项一
   - 无序嵌套一
   - 无序嵌套二
2. 有序项二
   - 无序嵌套一
   - 无序嵌套二

多级嵌套 #

1. 一级
   1. 二级
      1. 三级
         1. 四级

列表项内容 #

包含段落 #

1. 第一项

   这是第一项的详细说明段落。

2. 第二项

   这是第二项的详细说明段落。

包含代码块 #

1. 安装依赖

   ```bash
   npm install

2. 运行项目

   bash 复制代码

   npm start
   

### 包含引用

```markdown
1. 第一步

   > 这是一个提示信息

2. 第二步

   > 这是另一个提示信息

起始编号 #

从特定数字开始 #

部分解析器支持指定起始编号：

1. 第一项
2. 第二项

（其他内容）

4. 第四项        ← 会从 4 开始
5. 第五项

使用 HTML 控制 #

<ol start="5">
  <li>第五项</li>
  <li>第六项</li>
</ol>

列表样式 #

使用 HTML 改变样式 #

<ol type="A">
  <li>大写字母</li>
  <li>第二项</li>
</ol>

<ol type="a">
  <li>小写字母</li>
  <li>第二项</li>
</ol>

<ol type="I">
  <li>大写罗马数字</li>
  <li>第二项</li>
</ol>

<ol type="i">
  <li>小写罗马数字</li>
  <li>第二项</li>
</ol>

实际应用 #

安装步骤 #

## 安装步骤

1. 克隆仓库
   ```bash
   git clone https://github.com/user/repo.git

2. 安装依赖

   bash 复制代码

   cd repo
   npm install
   

3. 配置环境变量

   bash 复制代码

   cp .env.example .env
   

4. 启动项目

   bash 复制代码

   npm start
   

### 教程步骤

```markdown
## 快速开始

1. 创建项目目录
2. 初始化项目
3. 编写代码
4. 测试运行
5. 部署上线

版本历史 #

## 更新日志

1. v3.0.0 - 重大更新
   1. 重构核心模块
   2. 新增插件系统

2. v2.0.0 - 功能增强
   1. 添加用户系统
   2. 优化性能

3. v1.0.0 - 首次发布

常见问题 #

问题1：列表被中断 #

1. 项目一

   这里有空行，列表会继续

2. 项目二

这里有段落内容，列表被中断

3. 项目三    ← 会开始新列表

问题2：数字与点之间无空格 #

1.项目一      ← 错误
1. 项目一     ← 正确

问题3：缩进不一致 #

1. 项目一
  1. 嵌套项    ← 缩进不一致
   2. 嵌套项   ← 缩进不一致

最佳实践 #

1. 步骤说明使用有序列表 #

好的：
1. 第一步
2. 第二步
3. 第三步

不好的：
- 第一步
- 第二步
- 第三步

2. 保持缩进一致 #

1. 项目一
   1. 嵌套项（保持 3 空格缩进）
   2. 嵌套项
2. 项目二

3. 长列表项换行对齐 #

1. 这是一个比较长的列表项，
   可以换行继续写，
   保持缩进对齐。
2. 另一个列表项

有序 vs 无序列表 #

下一步 #

继续学习 任务列表！