Using Claude Code: The Unreasonable Effectiveness of HTML

Simon Willison's Blog Tools
html-outputs prompting-techniques anthropic claude-code developer-tools ai-artifacts

Summary

Simon Willison discusses the effectiveness of using HTML instead of Markdown as AI output format, highlighting benefits like SVG diagrams, interactive widgets, and rich explanations. Includes examples from Thariq Shihipar on Anthropic's Claude Code team and practical prompts for GPT-5.5.

No content available
Original Article Export to Word Export to PDF
View Cached Full Text

Cached at: 05/08/26, 10:27 PM

# Using Claude Code: The Unreasonable Effectiveness of HTML Source: [https://simonwillison.net/2026/May/8/unreasonable-effectiveness-of-html/](https://simonwillison.net/2026/May/8/unreasonable-effectiveness-of-html/) 8th May 2026 \- Link Blog **[Using Claude Code: The Unreasonable Effectiveness of HTML](https://twitter.com/trq212/status/2052809885763747935)**\. Thought\-provoking piece by Thariq Shihipar \(on the Claude Code team at Anthropic\) advocating for HTML over Markdown as an output format to request from Claude\. The article is crammed with interesting examples \(collected on[this site](https://thariqs.github.io/html-effectiveness/)\) and prompt suggestions like this one: > `Help me review this PR by creating an HTML artifact that describes it\. I'm not very familiar with the streaming/backpressure logic so focus on that\. Render the actual diff with inline margin annotations, color\-code findings by severity and whatever else might be needed to convey the concept well\.` I've been defaulting to asking for most things in Markdown since the GPT\-4 days, when the 8,192 token limit meant that Markdown's token\-efficiency over HTML was extremely worthwhile\. Thariq's piece here has caused me to reconsider that, especially for output\. Asking Claude for an explanation in HTML means it can drop in SVG diagrams, interactive widgets, in\-page navigation and all sorts of other neat ways of making the information more pleasant to navigate\. I wrote about[Useful patterns for building HTML tools](https://simonwillison.net/2025/Dec/10/html-tools/)last December, but that was focused very much on interactive utilities like the ones on my[tools\.simonwillison\.net](https://tools.simonwillison.net/)site\. I'm excited to start experimenting more with rich HTML explanations in response to ad\-hoc prompts\. #### Trying this out on copy\.fail [copy\.fail](https://copy.fail/)describes a recently discovered Linux security exploit, including a proof of concept distributed as obfuscated Python\. I tried having GPT\-5\.5 create an HTML explanation of the exploit like this: > `curl https://copy\.fail/exp \| llm \-m gpt\-5\.5 \-s 'Explain this code in detail\. Reformat it, expand out any confusing bits and go deep into what it does and how it works\. Output HTML, neatly styled and using capabilities of HTML and CSS and JavaScript to make the explanation rich and interactive and as clear as possible'` Here's[the resulting HTML page](https://gisthost.github.io/?ae53e3461ffdbfd0826156aacf025c7e)\. It's pretty good, though I should have emphasized explaining the exploit over the Python harness around it\. ![Screenshot of a dark-themed technical document titled "What this Python script does". Body text: "This is a compact, deliberately obfuscated Linux-specific local privilege-escalation proof-of-concept. Its apparent goal is to tamper with the in-memory image/page cache of /usr/bin/su, then execute su to obtain elevated privileges." A yellow-bordered callout reads: "Safety note: This explanation is for code understanding, reverse engineering, and defensive analysis. Do not run this on systems you do not own or administer. On a vulnerable kernel, code like this can alter the behavior of a privileged executable." Left column heading "High-level summary": "The script opens /usr/bin/su read-only, decompresses an embedded binary payload, and then processes that payload in 4-byte chunks. For each chunk, it performs a carefully arranged sequence involving Linux's kernel crypto socket interface, AF_ALG, pipes, and splice(). The important point is that this is not ordinary file writing. It never calls write() on /usr/bin/su. Instead, it appears to rely on a kernel bug/primitive involving spliced file pages and the crypto API to get controlled bytes placed into the page-cache representation of a privileged executable." Numbered steps follow: "1. Open target executable — /usr/bin/su is opened read-only. 2. Decode hidden payload — A zlib-compressed hex blob is decompressed into bytes. 3. Patch in 4-byte chunks — The helper function is called repeatedly with offsets 0, 4, 8, ...". Right column heading "Why it looks strange" contains a table with Pattern and Purpose columns: "import os as g — Short aliasing to make the script compact and harder to read. socket(38, 5, 0) — Uses raw numeric Linux constants instead of readable names. Compressed hex blob — Hides binary payload bytes and keeps the script small. splice() — Moves file-backed pages through pipes without normal user-space copying. try: recv(...) except: 0 — Triggers the kernel operation and ignores expected errors."](https://static.simonwillison.net/static/2026/python-script-explainer.jpg)

Similar Articles

Using Claude Code: The unreasonable effectiveness of HTML

Hacker News Top

A blog post by a Claude Code team member argues for using HTML instead of Markdown as the preferred output format for AI agents like Claude Code, citing benefits such as richer information density, visual clarity, ease of sharing, and interactive capabilities.

@trq212: https://x.com/trq212/status/2052809885763747935

X AI KOLs Following

The article argues that HTML is a superior output format for AI agents compared to Markdown due to richer information density, visual clarity, ease of sharing, and two-way interaction, and shares why the author and others at Claude Code prefer HTML.

@AYi_AInotes: Claude's engineers have completely abandoned Markdown. It's not that Markdown doesn't work well—it's that AI has evolved too fast for it to keep up. Back when AI wrote 10 lines of notes, Markdown was perfect. Now AI can output 1000 lines of plans, complex flowcharts, and complete code reviews all at once—who has the patience to read through a wall of plain text?

X AI KOLs Timeline

Claude's engineers are ditching Markdown for HTML because AI output has grown from 10 lines to 1000 lines, making plain text formats impractical. HTML enables colored tables, SVG flowcharts, and interactive prototypes—significantly improving human-AI collaboration, albeit with 2-4x longer generation times.

@elliotchen100: Thariq from Anthropic’s viral HTML post hit 1.5M reads. On the surface, it’s about formatting aesthetics, but he’s actually outlining a brand-new workflow. Picking out the most technical points. First, HTML isn’t a document; it’s a throwaway editor. Take his example…

X AI KOLs Timeline

Analyzes a new AI development workflow shared by Anthropic employee Thariq, highlighting how replacing Markdown with HTML and SVG can dramatically improve multi-agent collaboration and interaction efficiency, offering a model better suited to human-AI synergy in the AI era.