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> 内。

📚 相关条目

无序列表CommonMark 核心 表格GFM 扩展 Emoji 表情GitHub 特性
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏