Using Claude Code: The unreasonable effectiveness of HTML
Claude Code is increasingly using HTML instead of Markdown for specs, plans, reviews, and interactive artifacts because it carries richer structure and context.
What Matters
- HTML can represent tables, CSS design data, SVG illustrations, scripts, interactions, absolute-position layouts, and images in one medium.
- Markdown becomes hard to read past 100 lines; HTML stays navigable with tabs, links, illustrations, and mobile-friendly layouts.
- Sharing improves because an HTML file can be uploaded and opened directly, instead of being buried in email attachments or chat.
- Interactive artifacts matter: sliders, knobs, copy-to-prompt buttons, and live parameter tuning turn documents into working tools.
- Claude Code can ingest codebases, MCPs like Slack and Linear, browser context, and git history to synthesize richer HTML reports.
- HTML is slower and noisier in version control, but the author says the readability tradeoff outweighs token efficiency.
- [HN: @BretonForearm] Many teams already had Claude Code generating HTML routinely, calling this presentation a novelty.