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中的图片