[DOCS] Interactive mode docs omit GFM task list checkbox rendering in markdown output
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/interactive-mode#task-list
Section/Topic
Task list section, specifically the difference between the Ctrl+T task list UI and markdown task list syntax rendered in normal Claude output
Current Documentation
The page currently says:
## Task list When working on complex, multi-step work, Claude creates a task list to track progress. Tasks appear in the status area of your terminal with indicators showing what's pending, in progress, or complete. PressCtrl+Tto toggle the task list view. The display shows up to 5 tasks at a time To see all tasks or clear them, ask Claude directly: "show me all tasks" or "clear all tasks" Tasks persist across context compactions, helping Claude stay organized on larger projects To share a task list across sessions, setCLAUDE_CODE_TASK_LIST_IDto use a named directory in~/.claude/tasks/:CLAUDE_CODE_TASK_LIST_ID=my-project claude
No documentation on this page currently explains that ordinary markdown output now renders GitHub Flavored Markdown task list syntax as checkboxes.
What's Wrong or Missing?
Changelog v2.1.149 says markdown output now renders GFM task list checkboxes (- [ ] todo / - [x] done) instead of plain bullets.
The current docs only describe Claude Code's separate session task list UI in the terminal status area. They do not document that markdown responses themselves support GFM task list syntax, and they do not distinguish that renderer behavior from the Ctrl+T task list.
That leaves users without documentation for three practical points:
A. Markdown checklist syntax support is undocumented
Readers cannot tell that - [ ] and - [x] are supported syntax in normal Claude output.
B. The feature is easy to confuse with the separate task list UI
The only nearby documentation is about Claude-managed tasks in the status area, which is a different feature from rendering checkboxes inside markdown responses.
Suggested Improvement
Add a short note or subsection near Task list explaining that Claude Code's markdown renderer supports GitHub Flavored Markdown task list syntax in normal output.
Suggested wording:
Claude Code renders GFM task list syntax in markdown output. Example: ``markdown - [ ] todo - [x] done`These render as checkboxes in the conversation output. This is separate from the session task list shown withCtrl+T`.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode#task-list | 328-335 | Documents the Ctrl+T task list UI, but not GFM checkbox rendering in normal markdown output |
Total scope: 1 page affected
Version context: Behavior changed in v2.1.149.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗