# Using Claude Code: The Unreasonable Effectiveness of HTML

Thariq makes the case for HTML over Markdown as Claude Code's output format — richer visualizations, color, diagrams, and easier sharing once agents are the ones authoring and humans rarely hand-edit.

**Type:** article
**Added:** 2026-05-15
**Author:** [Thariq (@trq212)](https://x.com/trq212)
**Link:** https://x.com/trq212/status/2052809885763747935?s=20
**Topics:** AI Coding, Frontend
**Tags:** agents

---

Markdown won as the default agent output format because it's portable and easy to hand-edit. Thariq's argument: once the human stops being the editor — files become specs, references, brainstorm dumps that you re-prompt rather than tweak — markdown's main benefit evaporates, and its weaknesses (>100 lines is painful, no real visuals, ASCII diagrams as a workaround) start to bite.

HTML buys you color, layout, diagrams, and a file you can just open and share. Examples: [thariqs.github.io/html-effectiveness](https://thariqs.github.io/html-effectiveness).

## Where I agree

Especially for prototyping. When the artifact is a one-shot spec or a visual reference I'll never edit by hand, HTML is strictly better than markdown — it renders, it's shareable, and the agent can express things markdown can't.

## Related

Matt Pocock ([@mattpocockuk](https://x.com/mattpocockuk)) announced he'll update his [improve-codebase-architecture skill](https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md) to output HTML instead of markdown. Adoption is starting.

---

## Links

- Directory entry: https://andrey-markin.com/directory/claude-code-html
- All directory entries: https://andrey-markin.com/directory
- Contact: https://andrey-markin.com/#contact