任务列表 #

概述 #

任务列表（Task Lists）是 GitHub Flavored Markdown 的扩展语法，用于创建带有复选框的列表项，非常适合追踪任务进度。

基本语法 #

在列表项中添加 [ ] 或 [x]：

markdown

- [ ] 未完成任务
- [x] 已完成任务

渲染效果：

[ ] 未完成任务
[x] 已完成任务

语法详解 #

未完成任务 #

markdown

- [ ] 待办事项

使用 [ ]（方括号内有空格）表示未完成。

已完成任务 #

markdown

- [x] 已完成事项

使用 [x]（方括号内有小写 x）表示已完成。

大小写皆可 #

markdown

- [x] 小写 x
- [X] 大写 X

与有序列表结合 #

markdown

1. [ ] 第一步
2. [x] 第二步
3. [ ] 第三步

渲染效果：

[ ] 第一步
[x] 第二步
[ ] 第三步

嵌套任务列表 #

markdown

- [ ] 主任务
  - [x] 子任务一
  - [x] 子任务二
  - [ ] 子任务三
- [ ] 另一个主任务
  - [ ] 子任务一
  - [ ] 子任务二

渲染效果：

[ ] 主任务
- [x] 子任务一
- [x] 子任务二
- [ ] 子任务三
[ ] 另一个主任务
- [ ] 子任务一
- [ ] 子任务二

实际应用 #

项目进度追踪 #

markdown

## 项目进度

- [x] 需求分析
- [x] 技术选型
- [x] 架构设计
- [ ] 开发阶段
  - [x] 用户模块
  - [x] 权限模块
  - [ ] 订单模块
  - [ ] 支付模块
- [ ] 测试阶段
- [ ] 部署上线

学习计划 #

markdown

## 学习计划

- [x] HTML 基础
- [x] CSS 基础
- [ ] JavaScript 基础
  - [x] 变量与数据类型
  - [x] 函数
  - [ ] DOM 操作
  - [ ] 事件处理
- [ ] 框架学习
  - [ ] React
  - [ ] Vue

会议记录 #

markdown

## 会议待办事项

- [x] 确认会议时间
- [x] 准备会议材料
- [ ] 发送会议邀请
- [ ] 预定会议室
- [ ] 会议记录整理

Bug 修复清单 #

markdown

## Bug 修复清单

- [x] #123 - 登录页面样式问题
- [x] #124 - 表单验证错误
- [ ] #125 - 分页功能异常
- [ ] #126 - 导出功能优化

任务列表样式 #

使用 emoji 增强 #

markdown

- [x] ✅ 已完成的功能
- [ ] ⏳ 进行中的功能
- [ ] 📋 待开发的功能

使用优先级标记 #

markdown

- [ ] 🔴 高优先级任务
- [ ] 🟡 中优先级任务
- [ ] 🟢 低优先级任务
- [x] ✅ 已完成

使用标签分类 #

markdown

## 开发任务

- [ ] [前端] 首页优化
- [ ] [后端] API 重构
- [ ] [测试] 单元测试
- [x] [文档] README 更新

GitHub 特性 #

在 GitHub 上，任务列表是可交互的：

点击复选框可以切换状态
状态会自动同步到源文件
可以在 Issues 和 PR 中使用

Issues 中的任务列表 #

markdown

## 待办事项

- [ ] 任务一
- [ ] 任务二
- [ ] 任务三

在 Issues 中会显示进度条。

PR 中的任务列表 #

markdown

## 本次更新

- [x] 新增功能
- [x] 修复 Bug
- [ ] 更新文档
- [ ] 添加测试

统计完成进度 #

手动添加进度：

markdown

## 任务进度：3/5 完成

- [x] 任务一
- [x] 任务二
- [x] 任务三
- [ ] 任务四
- [ ] 任务五

常见问题 #

问题1：复选框不显示 #

原因：语法错误

markdown

- [] 错误：括号内没有空格
- [ ] 正确：括号内有一个空格

问题2：与其他列表混用 #

markdown

- 普通列表项
- [ ] 任务项
- 另一个普通项

可以混用，但不推荐。

问题3：嵌套缩进问题 #

markdown

- [ ] 主任务
  - [ ] 子任务（正确：2空格缩进）
 - [ ] 错误缩进

最佳实践 #

1. 任务描述清晰 #

markdown

好的：
- [ ] 完成用户登录功能的开发

不好的：
- [ ] 登录

2. 合理拆分任务 #

markdown

好的：
- [ ] 实现登录页面 UI
- [ ] 实现登录 API
- [ ] 添加表单验证
- [ ] 编写单元测试

不好的：
- [ ] 完成登录功能

3. 及时更新状态 #

markdown

- [x] 已完成的任务及时标记
- [ ] 进行中的任务保持未完成状态

4. 使用嵌套组织任务 #

markdown

- [ ] 模块开发
  - [ ] 子任务一
  - [ ] 子任务二
  - [ ] 子任务三

任务列表 vs 普通列表 #

特性	任务列表	普通列表
复选框	有	无
进度追踪	支持	不支持
交互性	GitHub 支持	无
适用场景	待办事项	内容展示

下一步 #

继续学习列表嵌套！