HTML over MD files for outputs and more?

Today, I stumbled over this video short and just began looking at it. It's about HTML files handling a lot more that MD files. Some of what I found:

Thariq Shihipar from Anthropic's Claude Code team recently sparked a major industry debate by advocating for HTML over Markdown (.md) as the default format for AI agent outputs.

His core thesis, titled "The Unreasonable Effectiveness of HTML", argues that Markdown has become a "cognitive nightmare" for humans as AI models handle increasingly massive context windows and complex, multi-hundred-line tasks.

Why Anthropic Engineers are Ditching Markdown

The "Wall of Text" Problem: When Claude generates complex 200-line development plans or code reviews, humans stop reading them and just blindly skim or approve them.
Rich UI Elements: HTML natively supports collapsible sections, internal jump-links, side-by-side grids, and interactive scaffolding.
Native Visualizations: Instead of forcing AI to build ugly ASCII diagrams or fake charts using Unicode, HTML allows models to generate fully styled tables and actual SVG illustrations.
The Token Cost Trade-Off: While generating HTML consumes significantly more tokens and takes longer, modern context windows make the extra cost negligible compared to the massive value of a highly readable document.

Ultimately, the theory suggests that instead of viewing AI as just a text generator, outputs should be treated as dynamic, interactive interfaces that keep humans engaged in the loop.

Thariq Shihipar introduced the concepts in a widely discussed essay and social media breakdown titled Using Claude Code: The Unreasonable Effectiveness of HTML. He later expanded on these exact workflows and operational data during an interview on Lenny's Podcast.

I think adding an HTML file could look like the image I've attached. Where a clickable report for presentation for your prospect outlines everything in an easy-to-read format.

Love to know your thoughts on this.

2 comments