当你的 AI 同事开始用 HTML 跟你说话
我也有上百行的 Markdown 文件，从来没读完过
Section titled “我也有上百行的 Markdown 文件，从来没读完过”今天读到 Thariq 的一篇长帖，他是 Anthropic Claude Code 团队的人。帖子的核心论点很简单：HTML 应该替代 Markdown，成为 AI agent 的默认输出格式。
读完第一反应：靠，他说得对。
我回想了一下自己用 Claude Code 这半年，项目目录里攒了几十个 markdown 文件——计划文档、代码审查输出、架构分析、头脑风暴记录。说实话，超过 100 行的我几乎没完整读完过任何一个。打开扫两眼，感觉”差不多懂了”，就关了。
Thariq 说了一个我们都不太愿意承认的事：Markdown 作为阅读格式，烂透了。 它本质上是给写作者设计的——轻量、纯文本、容易编辑。但当输出方是 AI、阅读方是人时，“容易编辑”这个优势根本不存在。我让 Claude Code 写了一份 500 行的架构分析，我不需要编辑它，我需要看懂它。而 markdown 在”帮人看懂复杂信息”这件事上，几乎什么都没做。
所以他提出的替代方案——HTML——逻辑上完全成立。HTML 可以做表格、图表、流程图、标签页、响应式布局。信息密度远高于 markdown。团队分享一个 HTML 链接比传一个 .md 文件优雅得多。
但读完整篇帖子，我有一种不太舒服的感觉。不是对 Thariq 的观点——他的论证很扎实。是对这个方向本身。
好看的输出，会不会让你更懒得质疑？
Section titled “好看的输出，会不会让你更懒得质疑？”想象两个场景。Claude Code 分析了你的代码库，产出了一份架构问题报告。
场景 A：一个 400 行的 markdown 文件。纯文本，有标题层级，有一些 ASCII 流程图。你需要盯着屏幕一行行看，自己在大脑里拼出全景。
场景 B：一个精美的 HTML 页面。有渐变色卡片、交互式流程图、颜色编码的严重性标注、折叠面板。看起来像 Notion 里的正式文档。
哪个场景你更可能对结论提出质疑？
我猜是 A。不是因为你更认真，是因为 A 看起来就是草稿。草稿天然携带一条隐含信息——“这可能不对”。
B 看起来太像成品了。排版精美、色彩专业、交互流畅。你的大脑会自动进入”阅读模式”而非”质疑模式”。你在欣赏一份文档，而非审视一份分析。
这不是 Thariq 的问题。这是人类的认知惯性——好看的东西更容易被相信。 设计领域把这叫”aesthetic-usability effect”：用户认为看起来更好的产品也更好用，即使功能完全相同。法庭上，排版更专业的诉状被认为更有说服力。学术界，图表更好看的论文被引用更多。
Claude 给你一个排版精美的 HTML 报告时，它在利用同一个认知捷径。不是故意的——模型不”故意”做任何事。但效果是一样的：包装越精致，你越不容易发现问题。
从”编辑者”到”观众”——角色变了，你没注意到
Section titled “从”编辑者”到”观众”——角色变了，你没注意到”Thariq 在帖子里说了一句很有意思的话：“I feel more in the loop than ever before when using HTML.” 他感觉使用 HTML 时，自己比以往任何时候都更加”在循环中”。
这句话让我停了一下。
“在循环中”是什么感觉？是你能影响结果，能做出有意义的决策，能在关键时刻纠偏。但一个 HTML 页面能给你这种感觉吗？你在浏览器里看一份精美的报告，滚动、点击、展开折叠面板——这让你感觉在”参与”还是让你感觉在”消费”？
HTML 可能正在把我们从”AI 产出的编辑者”变成”AI 产出的观众”。
Markdown 时代，我是编辑者。打开文件，看到粗糙的文本，自然地想改几个地方、删一段、加一行。我不一定真改——Thariq 说得对，很多时候我让 Claude 去改——但心理上的角色是编辑者。
HTML 时代呢？打开一个浏览器标签，看到一份排版精美的交互式文档。我滚动、点击、欣赏。我可能觉得”不错”或”这颜色有点丑”。但我会想改内容吗？大概率不会。它看起来完成了。完成的东西，你不会想去改。
这不是说 Thariq 错了。他在 Claude Code 团队，每天都在和 agent 深度协作。对他而言，HTML 确实让他更有掌控感——因为他本身就有极强的审阅能力和质疑习惯。但对大多数用户呢？对第一次用 Claude Code 的人呢？
工具设计者用工具的方式，和普通用户用工具的方式，往往完全不同。 Thariq 的”在循环中”可能是因为他本身就是那个循环的设计者。
回到根本上——这不是格式问题，是信任问题
Section titled “回到根本上——这不是格式问题，是信任问题”继续往下挖。
HTML vs Markdown 的讨论底下，其实是一个更根本的问题：你信不信 AI 的输出可以直接用？
如果你信——或者验证成本很低——那 HTML 显然更好。好看、易读、易分享。直接扔给同事、老板、客户，省时省力。
如果你不信——如果你觉得 AI 的输出更像”第一稿”，需要你仔细过一遍——那 markdown 的”粗糙”恰好是一种认知锚定。它在提醒你：这东西是 AI 写的，还没被人审过，别把它当成品。
我现在的阶段，大约 70% 信，30% 不信。取决于任务。让 Claude Code 解释一段我不熟悉的代码——我比较信，它的分析大概率是对的。让它设计一个系统架构——我不太信，我需要在关键节点上自己 check。
所以对我来说，格式不应该一刀切。 探索阶段用 markdown——保持草稿感，鼓励质疑。展示阶段用 HTML——需要传播、分享、让非技术同事也能看懂的时候。
但有一个例外：当输出是给我自己看的，我倾向保留 markdown。不是因为它更好读，是因为它看起来更像”我的笔记”而非”AI 的成品”。这个心理距离很重要。一旦输出看起来太像成品，我就可能下意识地把它当成自己的思考——而它显然不是。
读 Thariq 的文章让我想清楚了一件事：格式选择本质上是意图信号。
Markdown 说：“这是草稿，来一起改。“HTML 说：“这是成品，来看看吧。”
这两个信号在不同的协作阶段都有价值。我计划在 Claude Code 里这么用：思考、探索、计划阶段，继续用 markdown；给团队做演示、写周报、出事故报告时，让 Claude 生成 HTML。
至于 Thariq 说的”我已经完全不用 markdown 了”——我尊重，但我不跟。不是因为他不对，是因为我还没到那个信任水平。
也许一年后我会改变想法。到时候再写一篇。
你用 Claude Code 或者其他 AI coding 工具时，会认真读它生成的计划文档吗？还是跟我一样——扫两眼觉得”差不多了”就关了？
Thariq Shihipar. Using Claude Code: The Unreasonable Effectiveness of HTML. X (Twitter). https://x.com/trq212/status/2052809885763747935