TL;DR

Ngày 8/5/2026, Thariq Shihipar - kỹ sư trong team Claude Code tại Anthropic - đăng lên X: "HTML is the new markdown. I've stopped writing markdown files for almost everything and switched to using Claude Code to generate HTML for me." Tweet đạt 1.7 triệu lượt xem, 7.016 likes và 552 replies. Kèm theo là gallery 20 HTML demo minh hoạ tại sao HTML output phong phú hơn Markdown nhiều lần.

Tại sao Markdown thống trị suốt bao nhiêu năm?

Câu trả lời ngắn gọn: token limit. Thời GPT-4 ra mắt với context window chỉ 8.192 tokens, Markdown là lựa chọn tối ưu vì nhẹ hơn HTML, dễ parse hơn, và tiết kiệm token đáng kể. Cộng đồng developer - bao gồm cả Simon Willison, tác giả nhiều open-source AI tool - đã mặc định request Markdown từ mọi LLM.

Nhưng context window đã thay đổi hoàn toàn. Claude 3 và các model gần đây hỗ trợ 100K-1M tokens. Token cost không còn là bottleneck. Câu hỏi lúc này không phải "định dạng nào nhẹ hơn?" mà là "định dạng nào trình bày thông tin tốt hơn?"

20 demo, 1 tuyên ngôn

Gallery của Thariq có 20 file HTML tự chứa (self-contained) - không cần build process, không cần server, mở thẳng bằng browser - được chia thành 9 danh mục:

  • Code Review: PR annotated với margin notes, severity tags color-coded, diffs giữ nguyên cấu trúc không bị flatten
  • Design: Living design system với color swatches, type scale, spacing tokens render live ngay trong file
  • Slide Deck: Điều hướng bằng phím mũi tên - không cần PowerPoint, không cần export
  • Prototype: Animation sandbox với slider chỉnh duration/easing; clickable flow 4 màn hình
  • Research: Concept explainer với interactive rings minh hoạ consistent hashing; collapsible steps
  • Reports: Weekly status với charts; incident timeline minute-by-minute với log excerpts
  • Custom Editors: Ticket triage board kéo thả; feature flag editor với dependency warnings; prompt tuner live

Như Simon Willison nhận xét: "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." Ông thừa nhận đã phải reconsider toàn bộ workflow sau khi đọc bài của Thariq.

Claude Code generate file HTML tự chứa - robot developer minh hoạ workflow mới

HTML làm được gì mà Markdown không?

Sự khác biệt không chỉ là "đẹp hơn" - mà là thay đổi cách thông tin được tiếp nhận:

  • Spatial data: Call-graphs, diffs, dependency trees bị Markdown flatten thành danh sách phẳng. HTML giữ nguyên cấu trúc không gian.
  • Interactivity: Sliders, tabs, toggle, drag-and-drop - những thứ không thể làm trong plain text.
  • Navigation: TOC với anchor links, tabs điều hướng, collapsible sections - người đọc kiểm soát thứ tự đọc.
  • Presentation quality: Markdown khiến người đọc skim qua; HTML được thiết kế để người đọc thực sự đọc.

Thariq đúc kết: "A handful of <section> tags and twenty lines of JS is a slide deck." Không cần build pipeline, không cần tool chain. Claude Code generate file HTML tự chứa, bạn mở browser là xong.

Khi nào Markdown vẫn thắng?

Đây là điều cộng đồng 552 replies đã tổng hợp thành consensus:

  • Instructions và context (CLAUDE.md, skills files): Markdown là chuẩn. Thậm chí executable scripts còn tốt hơn Markdown cho deterministic steps - tiết kiệm 90% tokens.
  • Version control: Markdown dễ diff, dễ review changes trong git. HTML phức tạp hơn nhiều.
  • Portability dài hạn: Plain text readable sau 50 năm mà không cần tool.
  • Quick answers: Với câu trả lời ngắn, danh sách đơn giản - HTML là overkill.

Nguyên tắc rõ ràng: HTML cho output (visualizations, reports, interactive content). Scripts/Markdown cho input (CLAUDE.md, skills, instructions).

Kết: unhobble output của bạn

Xu hướng "HTML is the new markdown" là một phần của movement lớn hơn trong Claude Code: unhobbling the model - gỡ bỏ những giới hạn không còn cần thiết khi AI capabilities tăng. Trước đây, token limit buộc chúng ta ép output vào khuôn Markdown. Bây giờ, không còn lý do gì để làm vậy.

Lần tới khi nhờ Claude giải thích codebase phức tạp, review architecture, hoặc tạo weekly report - thử thêm vào prompt: "Output HTML, styled, using capabilities of HTML and CSS and JavaScript." Kết quả sẽ khiến bạn không muốn quay lại Markdown.

Nguồn: Simon Willison - The Unreasonable Effectiveness of HTML | Demo gallery của Thariq | Tweet gốc @trq212