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