Markdown核取方塊
核取方塊(也稱為任務清單)是建立待辦事項清單、追蹤進度和在Markdown文件中組織任務的絕佳方式。它們在GitHub、GitLab和其他支援互動式核取方塊的平台上特別有用。
基本核取方塊語法
核取方塊語法使用方括號,內部包含空格或'x':
- [ ] 未選中的核取方塊
- [x] 已選中的核取方塊
- [ ] 另一個未選中的項目
結果:
- 未選中的核取方塊
- 已選中的核取方塊
- 另一個未選中的項目
重要語法規則
1. 空格要求
- •連字號後必須有空格:
- [ ]
而不是-[ ]
- •未選中時方括號內要有空格:
[ ]
而不是[]
- •已選中用小寫'x':
[x]
而不是[X]
2. 清單格式
核取方塊必須是清單的一部分(使用-
、+
或*
):
- [ ] 這個有效
* [ ] 這個也有效
+ [ ] 這個也有效
[ ] 這個無效(不在清單中)
巢狀核取方塊
您可以建立帶有子任務的巢狀任務清單:
- [ ] 主要任務
- [ ] 子任務1
- [x] 子任務2(已完成)
- [ ] 子任務3
- [x] 另一個主要任務
- [x] 它的子任務
結果:
- 主要任務
- 子任務1
- 子任務2(已完成)
- 子任務3
- 另一個主要任務
- 它的子任務
實際範例
每日待辦清單
## 今天的任務
- [ ] 檢查信件
- [ ] 審查專案提案
- [x] 上午10點團隊會議
- [ ] 更新文件
- [ ] 計劃明天的工作
專案規劃
## 網站重新設計專案
- [x] 研究階段
- [x] 使用者訪談
- [x] 競爭對手分析
- [x] 需求收集
- [ ] 設計階段
- [x] 線框圖
- [ ] 視覺設計
- [ ] 原型
與其他格式混合
您可以將核取方塊與其他Markdown格式結合:
- [x] **重要任務**(已完成)
- [ ] *常規任務*(進行中)
- [ ] 專案`程式碼審查`
- [ ] [文件連結](https://example.com)
- [ ] ~~已取消任務~~(刪除線)
結果:
- 重要任務(已完成)
- 常規任務(進行中)
- 專案
程式碼審查
- 文件連結
已取消任務(刪除線)
故障排除
常見問題
- 核取方塊不呈現:檢查間距和清單格式
- 不可互動:平台可能不支援互動式核取方塊
- 外觀不一致:不同平台的核取方塊樣式不同
正確vs錯誤的語法
❌ 錯誤:
-[ ] 連字號後沒有空格
- [] 方括號內沒有空格
- [X] 大寫X
[ ] 不在清單中
✅ 正確:
- [ ] 連字號後有空格
- [ ] 方括號內有空格
- [x] 小寫x
核取方塊非常適合組織任務和追蹤進度。它們使您的文件具有互動性,並有助於保持專案井然有序!
準備添加一些視覺內容嗎?接下來學習Markdown中的圖片。