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)
- [ ] ~~已取消任務~~(刪除線)

結果:

  • 重要任務(已完成)
  • 常規任務(進行中)
  • 專案程式碼審查
  • 文件連結
  • 已取消任務(刪除線)

故障排除

常見問題

  1. 核取方塊不呈現:檢查間距和清單格式
  2. 不可互動:平台可能不支援互動式核取方塊
  3. 外觀不一致:不同平台的核取方塊樣式不同

正確vs錯誤的語法

❌ 錯誤:

-[ ] 連字號後沒有空格
- [] 方括號內沒有空格
- [X] 大寫X
[ ] 不在清單中

✅ 正確:

- [ ] 連字號後有空格
- [ ] 方括號內有空格
- [x] 小寫x

核取方塊非常適合組織任務和追蹤進度。它們使您的文件具有互動性,並有助於保持專案井然有序!

準備添加一些視覺內容嗎?接下來學習Markdown中的圖片