Markdown Task Lists
Last updated: 2026-10-14
Task Lists GFM extension
Add [ ] or [x] after a list marker to render checkboxes. On GitHub, issues and PRs get real interactive checkboxes.
| Group | GFM Extensions |
|---|---|
| Spec level | GFM extension |
| Spec version | CommonMark 0.31.2 + GFM |
📝 Syntax
- [ ] todo
- [x] done▶ Live Example
Edit Markdown on the left, see the result on the right
💡 Key points
💡 Tip Keep a space after the bracket: - [x]text may not parse in some renderers.
ℹ️ Note Outside GitHub it usually renders as read-only checkboxes.
❓ FAQ
Q Can task lists nest?
A Yes — indent child items normally; states do not auto-link.
Q Is [X] uppercase valid?
A GitHub accepts both; lowercase is the portable choice.
Q What HTML does it produce?
A A disabled <input type="checkbox"> inside the <li>.
📚 See also
Unordered ListsCommonMark core TablesGFM extension EmojiGitHub feature