让AI写报告，结果总是Markdown格式回来。满篇##、粗体、项目符号。前几行还能看，然后越来越快地滑过去。超过100行？说实话，直接关掉了。
Anthropic Claude Code团队的Thariq Shihipar在五月发了一句话，48小时内在X上获得了1090万次浏览："HTML is the new Markdown."
Markdown到底哪里有问题？
Markdown成为AI输出的默认格式，其实是GPT-4时代留下的习惯。那时候上下文窗口只有8192个token。HTML结构上需要更多token，所以在有限空间里Markdown更有效率。
这个习惯延续到了2026年，但情况已经完全改变了。2026年的上下文窗口已达到100万token。即使HTML多用了5000个token，也只是总预算的0.5%。
还有一个更根本的变化。Thariq的核心观察："我不再手动编辑AI生成的文档了。我把它用作规范，或者传给下一个Claude会话。" Markdown最大的优势是"方便手动编辑"，但这个前提已经不成立了。
关键数据
据Thariq表示，AI生成的token中约99%不是生产代码，而是仪表板、界面、计划文档、状态更新等。向可视化转移已经在发生了。
跟Markdown比，到底哪里不一样？
亲自试试就能立刻感受到。Simon Willison用这个提示词分析了一个安全漏洞代码："详细解释这段代码。展开任何令人困惑的部分。用HTML输出，使用HTML、CSS和JavaScript的功能让解释变得丰富和交互式。"
结果包含了高级摘要、安全警告、逐步代码分析和比较表，全都带有标签页和折叠功能。这些用Markdown很难达到同等清晰度。
| Markdown | HTML | |
|---|---|---|
| 可读性（100行以上） | 眼睛开始滑过 | 标签·折叠·侧边导航 |
| 图表 | 文本ASCII艺术 | 内联SVG |
| 交互 | 不可能 | 滑块·按钮·开关 |
| 比较表 | 管道符（|） | 排序·着色·高亮 |
| 分享 | 需要Markdown阅读器 | 浏览器直接打开 |
| 生成速度 | 快（30秒） | 慢2-4倍（90-120秒） |
| Git版本控制 | 干净的diff | diff会有噪声 |
HTML的核心优势："Claude能读到的信息，几乎都可以用HTML高效地表现出来。"这是Thariq自己的话。 加上SVG图表、CSS样式和JavaScript交互，就能得到让人真正想读的输出。
当然，HTML并非总是最优解。Markdown在这些场景仍然更好：Git仓库（diff会变得嘈杂）、Agent间的数据传递（需要干净的解析）、20行以内的短回复，以及个人笔记或草稿。
开始的方法：只要这些
- 在提示词末尾加一行
在任何现有提示词后面加上："Output as a single self-contained HTML file." 仅此一句，Claude就会自动添加结构和样式。 - 只用于最终交付物（草稿保留Markdown）
草稿和修改过程用Markdown。最终报告、客户交付物、需要共享的文档切换到HTML。不需要一下子全都改变。 - 告诉它使用目的
"人会读这份报告。加上标签导航。适合打印。"或者："让我用滑块调整参数。"提供的用途信息越多，结果越好。 - 给它创作自由
Thariq的建议："whatever is needed"这个表达效果出乎意料地强大。"SVG、代码片段、模型——任何能给我最多上下文的东西都放进去。"给予信任能带来更有创意的输出。 - 尝试建立活的设计系统
如果有项目，把颜色、排版、组件整合到一个HTML文件里。这样就有了人和AI都能读取和使用的共同参考资料。
