Markdown is not the agent god format anymore... HTML is back.
A Claude Code team member just wrote a piece arguing that now claude teams prefers HTML over Markdown for agent outputs.
Funny timing, because not long ago everyone was saying Md was the perfect agent-era format: simple, portable, easy for both humans and models....
His argument is basically that agent outputs are getting too complex now. Specs, plans, PR reviews, research reports, design explorations… at some point a giant Markdown file just becomes a wall of text nobody reads.
HTML gives agents much higher information density. It can include layout, tables, CSS, SVG diagrams, images, code snippets, visual flows, colors, interactions, and even small one-off tools. Basically, if Claude can understand it, it can probably represent it more clearly in HTML.
The bigger shift is that humans are not manually editing these files as much anymore. They are using them as specs, reference docs, brainstorming outputs, or review surfaces, then asking Claude to edit them again. So Markdown’s biggest advantage-easy human editing-matters less than before.
He does admit HTML is slower, more token-heavy, and worse for version control diffs. But his argument is that better readability, sharing, visualization, and interaction are worth it.
So maybe Markdown is still great for agent memory and plain docs. But for human-in-the-loop agent work, HTML starts looking less like a document format and more like a temporary UI.
Funny little format war to me lol. Markdown was supposed to be the agent-native format. Now HTML is coming back like, “actually I was the operating surface all along.”
Original post link: https://x.com/trq212/status/2052809885763747935