[DOCS] Syntax highlighting docs missing Cedar policy file support
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
Theme and display / /theme syntax highlighting documentation
Current Documentation
The docs currently say:
|Ctrl+T| Toggle syntax highlighting for code blocks | Only works inside the/themepicker menu. Controls whether code in Claude's responses uses syntax coloring |
And:
|CLAUDE_CODE_SYNTAX_HIGHLIGHT| Set tofalseto disable syntax highlighting in diff output. Useful when colors interfere with your terminal setup |
And:
*language: Programming language of the edited file, such as"TypeScript","Python","JavaScript", or"Markdown". Returns"unknown"for unrecognized file extensions.
No documentation currently exists for Cedar policy syntax highlighting support or for the newly recognized .cedar and .cedarpolicy extensions.
What's Wrong or Missing?
Changelog v2.1.97 added syntax highlighting for Cedar policy files (.cedar, .cedarpolicy), but the docs do not mention that Claude Code now recognizes Cedar policy files as part of its built-in syntax-highlighting support.
Users working with Cedar policies cannot tell from the docs that:
A. Cedar policy files are now recognized
.cedar and .cedarpolicy are now treated as Cedar files instead of remaining undocumented/unrecognized file types.
B. The syntax-highlighting docs have no supported-file-type guidance
The current docs explain how to toggle or disable syntax highlighting, but they do not say which file extensions Claude Code recognizes or note that Cedar support was added in v2.1.97.
Suggested Improvement
Add a short supported-file-type note anywhere Claude Code documents built-in syntax highlighting, and explicitly include Cedar policy files starting in v2.1.97.
Minimum useful fix:
- Add a note in
interactive-mode(or a linked source-of-truth page) that Claude Code recognizes.cedarand.cedarpolicyas Cedar for syntax highlighting. - Cross-reference that source of truth from pages that currently mention syntax highlighting controls (
interactive-mode,env-vars, and related pages).
If Anthropic does not want to maintain a full exhaustive language matrix, a brief “recently added support” note for Cedar policy files would still close the gap created by the v2.1.97 changelog entry.
Impact
Low - Minor confusion or inconvenience
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | /theme syntax-highlighting controls |
| https://code.claude.com/docs/en/env-vars | CLAUDE_CODE_SYNTAX_HIGHLIGHT documents disabling highlighting but not supported file types |
| https://code.claude.com/docs/en/monitoring-usage | Notes that unrecognized file extensions return "unknown", but does not mention Cedar recognition |
| https://code.claude.com/docs/en/keybindings | Lists the syntax-highlighting toggle shortcut without any supported-language guidance |
Total scope: 4 pages affected
Source: Changelog v2.1.97
Changelog entry: Added syntax highlighting for Cedar policy files (.cedar, .cedarpolicy)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗