任務列表
任務列表(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: 本地文件的任務列表渲染