Why Claude Code outputs are moving from Markdown to HTML
The author argues that Markdown is too restrictive as an agent output format and documents his shift to HTML in Claude Code. HTML increases information density (tables, SVG, CSS, JS), makes long specs readable, is easier to share as a link, and supports two-way interaction via sliders or buttons. Use cases include exploration/specs, PR review with annotated diffs, design prototypes, research reports, and throwaway HTML editors that export 'copy as prompt' back to Claude Code. Trade-offs are acknowledged: generation is 2–4x slower, and HTML diffs make version control review harder. Full of concrete prompt examples for engineers working with agent workflows.