[DOCS] Interactive mode docs omit GFM task list checkbox rendering in markdown output

Open 💬 1 comment Opened May 22, 2026 by coygeek

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. Press Ctrl+T to 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, set CLAUDE_CODE_TASK_LIST_ID to 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 with Ctrl+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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗