Skip to content

任务列表

任务列表(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>

相关语法

练习

尝试创建以下任务列表:

  1. 一个个人学习计划的任务列表
  2. 一个项目开发的分阶段任务列表
  3. 一个包含多级嵌套的复杂任务结构
  4. 一个结合表情符号和优先级的任务管理系统

相关工具

任务管理工具

  • GitHub Projects: 原生支持任务列表
  • Notion: 强大的任务管理功能
  • Obsidian: 知识管理和任务跟踪
  • Todoist: 专业的任务管理应用

Markdown 编辑器

  • Typora: 所见即所得的任务列表编辑
  • Mark Text: 实时预览任务列表
  • Zettlr: 学术写作中的任务管理
  • Joplin: 开源的笔记和任务管理

浏览器扩展

  • Markdown Here: 邮件中使用任务列表
  • GitHub Task Lists: 增强 GitHub 任务列表功能
  • Markdown Viewer: 本地文件的任务列表渲染

由 Markdownlang.com 整理创建