跳到主要内容
返回博客
2026年11月12日星期四

Markdown 复选框怎么写?可复制的任务清单

用 Markdown 复选框记录待办和已完成事项。开头提供可复制的发布清单,说明列表符号、方括号和空格的位置,排查勾选框为什么显示成普通文字,并演示如何在 GitHub Issue、README 或进度汇报中使用。

Markdown 复选框怎么写?可复制的任务清单

未完成写 - [ ],已完成写 - [x]。把这份清单复制到支持 GitHub Flavored Markdown 的 README、Issue 或编辑器即可试用。

## Release checklist

- [x] Review the release notes
- [ ] Test the public link
- [ ] Check the mobile layout

核对空格和列表符号

每项以短横线加空格开头。方括号里放一个空格或 x,右括号后再留一个空格,接任务文字。做完一项时,改括号里的字符即可。GitHub Flavored Markdown 规范

看到的现象检查哪里
行首显示原样的方括号检查括号前有没有列表符号,右括号后有没有空格。
整份清单显示成代码只粘贴围栏内部的行,去掉首尾的反引号。
写法正确但仍是普通文字把同样的几行放到支持 GFM 任务列表的预览里试一下。

根据清单放置的位置使用

GitHub Issue 中的清单适合跟踪进度。放在 README 时,先预览文件,任务状态变化后再更新 Markdown 源码。需要子任务时,在父项下面缩进一条列表项,再确认预览出现了第二层。GitHub 任务列表文档

发给别人看时保存一张图

这个示例有一项已完成、两项待办。粘贴源码,在预览里确认三个方框,再导出 PNG 放到汇报或幻灯片里。需要继续勾选时,随图保留 Markdown。预览 Markdown 检查清单

版本发布清单的 PNG,一项已勾选,两项未勾选

打开原始 PNG