Anthropic says HTML is better than Markdown for AI outputs
Published on
An article came out on Anthropic’s blog that made quite a bit of noise over the last few weeks. The thesis is simple: good old Markdown is being left behind.

Thariq Shihipar, who works as an engineer on Claude Code, published the text “The Unreasonable Effectiveness of HTML” and, according to him, the argument isn’t only about aesthetics, but also about operations.
He says the Markdown format was perfect when context windows were small and every token mattered. Today, with models supporting millions of tokens (like Opus 4.7 and 4.8) and with a powerful harness, the cost of generating more complex responses is no longer a big problem… but your attention might be.
Be honest with me: when an agent hands you a giant technical specification in Markdown, do you actually read all of it?
I, at least, have caught myself asking Claude Code or Codex to generate a plan for some project, getting a wall of text and ending up not even opening it properly, just giving the agent the OK to keep going and move forward. The problem with that is that, at some point, you lose control of the reasoning and end up falling out of the loop.
And that’s where Thariq says HTML can be MUCH better. The HTML format lets you show that long stretch of text in a much more visual way, with navigable tabs, interactive SVG diagrams and sliders. And you can open all of it in the browser.
A real case: I was doing a specific fine-tuning of a BSC model and, after finishing, I wanted to study some specific steps and also pass it on to other people in a “recipe” or “tutorial” format. I asked Claude Code to take the step-by-step Markdown it had generated and turn it into a complete, beautiful HTML (not in those exact words haha). The difference in clarity when reading is really gigantic (I leave an excerpt of the tutorial in the image below).

What used to be something I’d maybe skip is now a file I actually open and navigate, and that’s a pleasure to read.
Here’s the link to the article on Anthropic’s blog.