Using Claude Code: The unreasonable effectiveness of HTML

· ai coding · Source ↗

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.

Original | Discuss on HN