任务列表
任务列表(Task Lists)是 GitHub Flavored Markdown 的扩展功能,用于创建可交互的待办事项列表,广泛应用于项目管理和任务跟踪。
基本任务列表语法
未完成任务
使用 - [ ]
创建未完成的任务项:
markdown
- [ ] 完成项目文档
- [ ] 编写单元测试
- [ ] 部署到生产环境
渲染效果:
- [ ] 完成项目文档
- [ ] 编写单元测试
- [ ] 部署到生产环境
已完成任务
使用 - [x]
或 - [X]
创建已完成的任务项:
markdown
- [x] 搭建项目框架
- [X] 设计数据库结构
- [x] 实现用户认证
渲染效果:
- [x] 搭建项目框架
- [X] 设计数据库结构
- [x] 实现用户认证
混合任务列表
markdown
## 项目开发进度
- [x] 需求分析
- [x] 技术选型
- [ ] 前端开发
- [x] 登录页面
- [x] 主页面
- [ ] 个人中心页面
- [ ] 后端开发
- [x] 用户管理 API
- [ ] 订单管理 API
- [ ] 支付接口
- [ ] 测试
- [ ] 单元测试
- [ ] 集成测试
- [ ] 部署上线
渲染效果:
项目开发进度
- [x] 需求分析
- [x] 技术选型
- [ ] 前端开发
- [x] 登录页面
- [x] 主页面
- [ ] 个人中心页面
- [ ] 后端开发
- [x] 用户管理 API
- [ ] 订单管理 API
- [ ] 支付接口
- [ ] 测试
- [ ] 单元测试
- [ ] 集成测试
- [ ] 部署上线
任务列表的格式规则
语法要求
元素 | 语法 | 说明 |
---|---|---|
列表标记 | - | 必须使用连字符 |
空格 |
| 连字符后必须有空格 |
复选框 | [ ] | 方括号内的空格表示未完成 |
已完成 | [x] 或 [X] | 方括号内的 x 表示已完成 |
文本 | 任意文本 | 复选框后必须有空格 |
正确格式示例
markdown
✅ 正确格式:
- [ ] 任务1
- [x] 任务2
- [X] 任务3
❌ 错误格式:
-[ ] 缺少空格
- [] 缺少复选框内容
- [o] 错误的标记符
* [ ] 错误的列表符号
嵌套任务列表
多级任务结构
markdown
- [ ] 📋 产品规划
- [x] 市场调研
- [x] 竞品分析
- [ ] 用户访谈
- [x] 准备访谈问题
- [ ] 联系目标用户
- [ ] 进行访谈
- [ ] 整理访谈结果
- [ ] 需求文档编写
- [ ] 🎨 UI/UX 设计
- [ ] 原型设计
- [x] 低保真原型
- [ ] 高保真原型
- [ ] 视觉设计
- [ ] 色彩方案
- [ ] 图标设计
- [ ] 页面设计
- [ ] 💻 技术开发
- [x] 技术架构设计
- [ ] 前端开发
- [ ] 后端开发
- [ ] 数据库设计
渲染效果:
[ ] 📋 产品规划
- [x] 市场调研
- [x] 竞品分析
- [ ] 用户访谈
- [x] 准备访谈问题
- [ ] 联系目标用户
- [ ] 进行访谈
- [ ] 整理访谈结果
- [ ] 需求文档编写
[ ] 🎨 UI/UX 设计
- [ ] 原型设计
- [x] 低保真原型
- [ ] 高保真原型
- [ ] 视觉设计
- [ ] 色彩方案
- [ ] 图标设计
- [ ] 页面设计
- [ ] 原型设计
[ ] 💻 技术开发
- [x] 技术架构设计
- [ ] 前端开发
- [ ] 后端开发
- [ ] 数据库设计
任务列表增强
使用表情符号分类
markdown
## 📅 本周任务计划
### 🔥 高优先级
- [x] 🐛 修复登录页面 bug
- [ ] 🚀 发布 v2.1 版本
- [ ] 📊 完成季度报告
### 📋 常规任务
- [x] 📝 更新文档
- [ ] 🧪 编写测试用例
- [ ] 🔍 代码审查
### 💡 改进建议
- [ ] ⚡ 优化页面加载速度
- [ ] 🎨 改进用户界面
- [ ] 📱 适配移动端
渲染效果:
📅 本周任务计划
🔥 高优先级
- [x] 🐛 修复登录页面 bug
- [ ] 🚀 发布 v2.1 版本
- [ ] 📊 完成季度报告
📋 常规任务
- [x] 📝 更新文档
- [ ] 🧪 编写测试用例
- [ ] 🔍 代码审查
💡 改进建议
- [ ] ⚡ 优化页面加载速度
- [ ] 🎨 改进用户界面
- [ ] 📱 适配移动端
添加详细信息
markdown
- [ ] **用户注册功能** `重要`
- 实现邮箱注册
- 添加手机号验证
- 集成第三方登录(微信、QQ)
- **截止日期**: 2023-12-15
- **负责人**: 张三
- [x] **支付系统集成** `已完成`
- 支付宝接口
- 微信支付接口
- 银行卡支付
- **完成日期**: 2023-11-20
- **负责人**: 李四
- [ ] **数据库优化** `进行中`
- 查询性能优化
- 索引重建
- 数据清理
- **预计完成**: 2023-12-10
- **负责人**: 王五
渲染效果:
[ ] 用户注册功能
重要
- 实现邮箱注册
- 添加手机号验证
- 集成第三方登录(微信、QQ)
- 截止日期: 2023-12-15
- 负责人: 张三
[x] 支付系统集成
已完成
- 支付宝接口
- 微信支付接口
- 银行卡支付
- 完成日期: 2023-11-20
- 负责人: 李四
[ ] 数据库优化
进行中
- 查询性能优化
- 索引重建
- 数据清理
- 预计完成: 2023-12-10
- 负责人: 王五
实际应用场景
1. 项目管理
markdown
# 电商网站开发项目
## Sprint 1 (2023-11-01 - 2023-11-15)
### 🎯 Sprint 目标
完成用户系统和基础商品管理功能
### 📋 任务列表
#### 用户系统 👤
- [x] 用户注册/登录
- [x] 邮箱验证
- [x] 密码重置
- [ ] 用户资料管理
- [ ] 头像上传
#### 商品管理 🛍️
- [x] 商品列表展示
- [x] 商品详情页
- [ ] 商品搜索功能
- [ ] 商品分类筛选
- [ ] 商品评价系统
#### 购物车 🛒
- [ ] 添加到购物车
- [ ] 购物车商品管理
- [ ] 购物车数量更新
- [ ] 购物车结算
### 🐛 Bug 修复
- [x] 登录状态异常
- [x] 图片加载失败
- [ ] 页面响应慢
- [ ] 移动端适配问题
### 📝 文档更新
- [x] API 文档
- [ ] 用户手册
- [ ] 部署文档
2. 学习计划
markdown
# 🎓 JavaScript 深度学习计划
## 第一阶段:基础巩固 (Week 1-2)
### ES6+ 新特性
- [x] let/const 变量声明
- [x] 箭头函数
- [x] 模板字符串
- [x] 解构赋值
- [ ] 扩展运算符
- [ ] Promise 和 async/await
- [ ] 模块化 (import/export)
### DOM 操作
- [x] 元素选择和操作
- [x] 事件处理
- [ ] 动态创建元素
- [ ] 样式操作
- [ ] 表单处理
## 第二阶段:进阶内容 (Week 3-4)
### 函数式编程
- [ ] 高阶函数
- [ ] 纯函数和副作用
- [ ] 函数组合
- [ ] 柯里化
- [ ] 闭包深入理解
### 异步编程
- [x] 回调函数
- [x] Promise
- [ ] async/await 最佳实践
- [ ] 错误处理
- [ ] 并发控制
### 性能优化
- [ ] 代码分割
- [ ] 懒加载
- [ ] 内存管理
- [ ] 性能监测工具
## 学习笔记 📚
- [x] 每日学习总结
- [ ] 代码示例整理
- [ ] 难点问题记录
- [ ] 实践项目开发
3. 会议记录
markdown
# 📅 产品团队周会 (2023-11-20)
## 会议议程
### 📊 上周工作回顾
- [x] 产品需求评审
- [x] 用户反馈分析
- [x] 竞品调研报告
- [x] 数据分析报告
### 🎯 本周工作计划
- [ ] 新功能原型设计
- [ ] 用户体验优化方案
- [ ] 技术可行性评估
- [ ] 上线计划制定
### 🚧 待解决问题
- [ ] **用户流失率偏高**
- 分析流失原因
- 制定改进措施
- 跟踪改进效果
- [ ] **页面加载速度慢**
- 技术团队调研
- 优化方案设计
- 实施时间安排
### 📋 Action Items
- [ ] 张三:完成用户调研问卷 (本周五前)
- [ ] 李四:提交原型设计 (下周二前)
- [ ] 王五:技术方案评估 (下周三前)
- [ ] 赵六:竞品分析更新 (本周四前)
### 📝 会议决议
- [x] 确定下个月产品路线图
- [x] 批准用户体验改进预算
- [ ] 制定团队协作规范
4. 个人 GTD 系统
markdown
# 🗂️ 个人任务管理系统
## 📬 收集箱 (Inbox)
- [ ] 回复客户邮件
- [ ] 整理桌面文件
- [ ] 预约牙医检查
- [ ] 研究新的学习课程
## 🎯 今日重点 (MIT - Most Important Tasks)
1. [ ] 🔥 完成项目提案 (2小时)
2. [ ] 📞 与团队成员一对一会议 (1小时)
3. [ ] 📚 阅读技术文档 (30分钟)
## 📅 本周计划
- [ ] **工作任务**
- [x] 周一:项目启动会议
- [x] 周二:需求分析
- [ ] 周三:原型设计
- [ ] 周四:技术评审
- [ ] 周五:周总结
- [ ] **个人发展**
- [x] 完成在线课程第3章
- [ ] 写技术博客文章
- [ ] 参加技术分享会
- [ ] 更新简历
- [ ] **生活安排**
- [x] 健身房锻炼 (周一、三、五)
- [ ] 与朋友聚餐
- [ ] 看电影
- [ ] 整理房间
## 📚 等待中 (Waiting For)
- [ ] 等待设计师提供素材
- [ ] 等待客户反馈
- [ ] 等待服务器部署完成
## 💡 总有一天 (Someday/Maybe)
- [ ] 学习新的编程语言
- [ ] 写一本技术书籍
- [ ] 开发个人项目
- [ ] 去日本旅行
常见错误和解决方案
1. 语法错误
markdown
❌ 错误的格式:
-[ ] 缺少空格
-[] 复选框为空
- [o] 错误的标记
* [x] 错误的列表符号
✅ 正确的格式:
- [ ] 未完成任务
- [x] 已完成任务
- [X] 已完成任务(大写也可以)
2. 嵌套问题
markdown
❌ 错误的嵌套:
- [ ] 主任务
- [ ] 子任务(缺少缩进)
✅ 正确的嵌套:
- [ ] 主任务
- [ ] 子任务(正确缩进)
- [ ] 另一个子任务
3. 复选框位置
markdown
❌ 错误位置:
- 任务描述 [ ](复选框在后面)
✅ 正确位置:
- [ ] 任务描述(复选框在前面)
支持平台
GitHub/GitLab
- ✅ 完全支持交互式复选框
- ✅ 可在网页界面直接点击切换状态
- ✅ 支持 Issue 和 Pull Request 中使用
编辑器支持
- VS Code: 完全支持,可点击切换
- Typora: 支持可视化编辑
- Obsidian: 支持交互式任务列表
- Notion: 自动转换为待办事项
静态网站生成器
- VitePress: 支持渲染(不可交互)
- GitBook: 支持任务列表显示
- Docsify: 需要插件支持
- Jekyll: GitHub Pages 原生支持
最佳实践
1. 保持简洁明了
markdown
✅ 推荐:简洁的任务描述
- [ ] 修复登录bug
- [ ] 更新文档
- [ ] 部署到测试环境
❌ 不推荐:过长的描述
- [ ] 需要修复用户在使用邮箱登录时遇到的各种奇怪问题...
2. 使用分类和优先级
markdown
✅ 推荐:有组织的任务列表
## 🔥 紧急任务
- [ ] 修复生产环境bug
## 📋 常规任务
- [ ] 代码审查
- [ ] 文档更新
## 💡 改进想法
- [ ] 性能优化
- [ ] 新功能开发
3. 定期更新和维护
markdown
✅ 推荐:及时更新状态
- [x] ~~已完成的任务~~(可以使用删除线)
- [ ] 进行中的任务
- [ ] 待开始的任务
# 本周总结(定期回顾)
- 完成任务:3个
- 待完成任务:2个
- 新增任务:1个
HTML 输出
Markdown 任务列表转换为 HTML:
markdown
- [ ] 未完成任务
- [x] 已完成任务
转换为:
html
<ul>
<li><input type="checkbox" disabled> 未完成任务</li>
<li><input type="checkbox" checked disabled> 已完成任务</li>
</ul>
相关语法
练习
尝试创建以下任务列表:
- 一个个人学习计划的任务列表
- 一个项目开发的分阶段任务列表
- 一个包含多级嵌套的复杂任务结构
- 一个结合表情符号和优先级的任务管理系统
相关工具
任务管理工具
- GitHub Projects: 原生支持任务列表
- Notion: 强大的任务管理功能
- Obsidian: 知识管理和任务跟踪
- Todoist: 专业的任务管理应用
Markdown 编辑器
- Typora: 所见即所得的任务列表编辑
- Mark Text: 实时预览任务列表
- Zettlr: 学术写作中的任务管理
- Joplin: 开源的笔记和任务管理
浏览器扩展
- Markdown Here: 邮件中使用任务列表
- GitHub Task Lists: 增强 GitHub 任务列表功能
- Markdown Viewer: 本地文件的任务列表渲染