Markdown 任务列表
最后更新:2026-10-14
任务列表 GFM 扩展
在无序列表项的方括号里写空格或 x(- [ ] / - [x]),渲染成可勾选的清单。在 GitHub 的 Issue 和 PR 里可以真实点击勾选。
| 所属分组 | GFM 扩展 |
|---|---|
| 规范层级 | GFM 扩展 |
| 规范版本 | CommonMark 0.31.2 + GFM |
📝 语法
- [ ] 未完成
- [x] 已完成
▶ 在线示例
在左侧编辑 Markdown,右侧实时看效果
💡 要点
💡 提示 方括号与文字之间要有一个空格:- [x]文字 少了空格部分渲染器不认。
ℹ️ 说明 普通 Markdown 环境(如静态博客)里通常渲染为只读复选框,不可点击。
❓ 常见问题
Q 任务列表能嵌套吗?
A 能,子项正常缩进即可,父子勾选状态互不联动。
Q 大写 [X] 可以吗?
A GitHub 支持 x 和 X;严谨起见跨平台发布用小写。
Q 渲染成什么 HTML?
A <input type="checkbox" disabled> 加在 <li> 内。