Claude Code 团队怎么选文档格式（MD vs HTML）以及我的看法
Claude Code 团队的 Thariq 发了一篇文章，主张让 AI 输出 HTML 而不是 Markdown，几小时破百万阅读。我的看法：别争格式优劣，小孩儿才做选择题，我们都要——人读选 HTML，Agent 读选 Markdown。
今天上午刷到 Thariq 的一篇文章，标题叫《Using Claude Code: The Unreasonable Effectiveness of HTML》。
他是 Anthropic Claude Code 团队的成员，这篇文章发出后几小时内就破了百万阅读，持续扩散，在 AI 工具圈里引发了相当大的讨论。
他的核心主张：在用 Claude Code 做实际工作的时候，他已经把 HTML 而不是 Markdown 作为 AI 的默认输出格式，而且越来越多的团队成员也在这样做。
我看了之后觉得，这件事值得认真想一想。
为什么这个问题现在才变得重要？
Markdown 之所以流行，靠的是两条腿：人容易写，人容易改。语法简单，任何编辑器都能打开。
但 Thariq 注意到了一件事：当 Claude 替你写、替你改之后，这两条腿都不再是你的需求了。你真正剩下来的只有一个问题：这份文档，你能不能读得进去？
这才是问题的根。
HTML 赢在哪里
Thariq 列了很多理由，我觉得真正有说服力的是三条：
信息密度。Markdown 能做标题、列表、代码块。HTML 能做可排序的表格、SVG 图表、标签页导航、带颜色分级的 diff 视图。几乎没有什么 Claude 能理解的信息，是 HTML 无法表达的。
可分享性。Markdown 在浏览器里渲染很烂，要分享只能发附件。HTML 丢到 S3 或任何静态托管，一个链接搞定，手机也能看。同样是规格文档或 PR 说明，做成 HTML 被人真正读完的概率高得多。
双向交互。你可以让 Claude 在 HTML 里加滑块和按钮，调完参数之后点"复制成 Prompt"粘回 Claude 继续迭代。这是 Markdown 根本做不到的事。
反对意见里有几条值得看
评论区不是一边倒。
Token 消耗：HTML 生成时间是 Markdown 的 2–4 倍。Thariq 的回应是 Opus 4.7 有 100 万 token 上下文，这点消耗不是瓶颈。但跑批量任务或用较小模型时，差距会被放大。
版本控制：这是他自己承认的最大短板——HTML diff 嘈杂，很难 review。文档如果需要跟代码库一起版本管理，这个问题没有好答案。
Agent 读 Markdown 更高效：评论区有人说得很准：".md for everything the agent reads, html for everything the agent makes for me to read."——消费者不同，格式也应该不同。
我自己的看法
Thariq 的场景相对特殊：Anthropic 内部、Claude Code、输出给自己或小团队看、不需要严格版本管理。他说的 HTML 优势在这个场景下是真实的。
更通用的框架是问：这份文档的主要消费者是谁？
但他的论点里有一个内核，我觉得超出了这个场景：在 AI 大量介入创作之后，格式选择的逻辑从"我写起来顺不顺手"变成了"我读起来够不够高效"。 这个转变是真实发生的。
他还提到一个具体做法：规划阶段不再写线性的 Markdown 计划，而是让 Claude 先生成多个方向的探索 HTML，挑一个深入，做出带交互的原型，最后再写实现计划——这批文件还会作为下一个 Session 的上下文输入。
这不只是换个格式的问题，是整个工作流的结构在变。
