一个有意思的细节：Claude Code 团队成员 Thariq 说，自己现在越来越少让 Claude Code 写 Markdown，转而让它生成 HTML 文件或 HTML artifact。

这不是 Anthropic 的官方路线图，也不是 Claude Code 要把 Markdown 淘汰掉。它更像一线开发者在工作流里摸到的一块硬骨头：AI 生成的答案越来越长，长到 Markdown 的“清简”开始变成负担。

新补上的关键细节在这里：HTML 不只是让 AI 答案更好看，而是把实现计划、PR 审查、设计原型、跨工具报告，甚至临时编辑器，变成一个浏览器里能直接操作的工作面板。

一句话说，这件事的重点不是格式之争。

是 AI 答案开始从“文本”变成“界面”。

发生了什么：Claude Code 被拿来生成 HTML 工作面板

Thariq 提到的用法很具体。

他会让 Claude Code 生成 HTML 文件或 HTML artifact，用在这些场景里：

  • 实现计划.把方案、数据流、关键代码、mockup 放到一个页面里。
  • PR 解释与审查.展示内联 diff、风险标色、代码注释和逻辑说明。
  • 设计原型.用 CSS、按钮、滑块快速试颜色、布局、交互。
  • 跨工具报告.从代码库、Slack、Linear、git 历史里抽信息，压成可读页面。
  • 一次性小工具.拖拽排序、表单输入、提示词编辑器、JSON 生成器。

这类页面不一定进入正式产品，也不一定长期保存。很多时候，它就是一次会议、一轮审查、一个决策前的临时界面。

这反而是重点。

过去文档的默认形态是“写给人读”。现在 AI 代理生成的文档，越来越像“帮人完成判断”。两者不是一个东西。

为什么重要：Markdown 的护城河被 AI 代理挖薄了

Markdown 以前在开发团队里好用，因为它便宜、干净、可 diff、可复制，GitHub、Notion、Linear、静态站点都认。

它的核心优势是人类手写成本低。

但 AI 代理改了这个前提。

当规格说明、PR 解读、事故复盘、ticket 重排不再由人逐字敲出来，而是由 Claude Code、Cursor、Copilot Chat 或 Gemini Code Assist 从上下文里生成，Markdown 最大的优势就被削弱了一截。

人不再负责“写完每一行”。人更像在验收、筛选、追问和决策。

这时，Markdown 的短板会变得刺眼：

场景Markdown 常见问题HTML 的变化
长实现计划百行之后没人愿意认真读用布局、图示、代码块拆出判断路径
PR 审查GitHub diff 对复杂逻辑不友好标色风险、嵌入注释、分层解释
设计原型难表达颜色、动效、交互直接做可点原型
多源报告信息堆成文字墙浏览器页面承载表格、筛选、跳转
临时编辑器文本描述结构化操作很别扭表单、拖拽、复制 JSON 一步完成

HTML 的价值不是“炫”。

它是把复杂判断变得可见。把隐藏在一堆段落里的关系、风险和选择，摊到屏幕上。

这对 AI 编程尤其关键。模型能写很多，但人类的阅读耐心没有同步扩容。模型看着更强，产品反而更虚，很多时候就虚在“输出没人读”。

HTML 至少把这件事往回拉了一点。

谁最受影响：不是普通用户，是开发团队负责人

普通用户没必要关心自己该不该从 Markdown 迁到 HTML。

真正该看这件事的人，是已经在团队里用 AI 代理做开发协作的人，尤其是 tech lead、工程经理、产品技术负责人。

他们每天面对的不是“AI 会不会写代码”这种大问题，而是更烦的小问题：

  • 一个复杂方案怎么让同事快速看懂？
  • 一个 PR 的风险点怎么不被淹没在 diff 里？
  • 一个跨 Slack、Linear、git、代码库的背景，怎么别变成 300 行总结？
  • 一次性决策页面做不做，谁来做，做完要不要留？

Thariq 这条观察真正补强的，是“上下文入口”这个变量。

Claude Code 不只是会生成 HTML。它能读本地文件系统，能结合 git 历史，也能通过 MCP 接 Slack、Linear 等数据源。这样生成出来的 HTML，就不是一个漂亮壳子，而是一个把多源上下文压缩后的工作台。

这就解释了为什么这件事不是“复古网页回潮”。

浏览器一直在。HTML 一直在。真正变化的是，过去没人愿意为一次性判断手写一个页面；现在 AI 代理把这个成本打下来了。

“天下熙熙，皆为利来。”放到工具史里也一样。格式会不会流行，不看情怀，看成本曲线。成本一变，旧格式就会被重新定价。

但别急着把 Markdown 扔了

HTML 不是 Markdown 的全面替代品。

这个边界必须讲清。否则又会变成工具圈熟悉的那种病：看见一个新姿势，就想给所有问题换一把锤子。

Thariq 也提到，HTML 通常更耗 token，生成时间可能是 Markdown 的 2 到 4 倍。进版本控制以后，diff 也更吵。一个 CSS 样式改动，可能让审查者比看 Markdown 更痛苦。

短会议纪要、README 小改、配置说明、团队规范，Markdown 仍然更合适。

HTML 适合的是另一类东西：

  • 信息密度高。
  • 读者不止一个。
  • 需要快速判断。
  • 最好能点、能筛、能改、能导出。
  • 生命周期短，做完服务一轮决策即可。

如果企业有严格审计、归档、版本留痕和合规要求，HTML artifact 还可能变成新的技术债。今天它是临时页面，明天它就可能没人敢删、没人敢改、没人知道里面的脚本能不能信。

表达力越强，治理成本越高。

这是老规律。报纸有版面权，电视有频道权，网页有入口权。AI 生成界面以后，也会有新的控制权：谁决定页面怎么组织，风险怎么标色，哪些信息被放在首屏，哪些被折叠到下面。

这里不完全等同于旧媒体史，但权力结构很像。界面从来不是中性的。它会替你安排注意力。

我更在意的，是 AI 产品正在偷换“答案”的形态

很多人讨论 AI 工具，还停在“回答准不准”“代码能不能跑”。这当然重要，但不够。

下一步的分水岭，可能是 AI 能不能把答案做成一个可协作的界面。

文本答案的问题是，它把负担甩给读者。你要自己读、自己比、自己找风险、自己决定下一步。

界面答案不一样。它会提前替你分组、标色、排序、折叠，把一部分认知工作做掉。

这听起来很美，也很危险。

美在效率。一个团队如果能把复杂 PR、事故分析、迁移计划做成临时 HTML 面板，阅读率大概率会比丢一篇长 Markdown 高。很多所谓“团队没有共识”，其实不是观点冲突，是没人读完同一份材料。

危险在激励。模型生成界面以后，很容易把“不确定”包装成“看起来很确定”。颜色、布局、图表、按钮都会制造权威感。一个标红的风险点，可能真的重要，也可能只是模型理解错了代码路径。

所以判断这类 HTML artifact 好不好，不该看页面漂不漂亮。

要看三件事：

  • 它有没有减少关键读者的判断成本。
  • 它有没有暴露证据来源和不确定性。
  • 它的生命周期有没有被控制住，别从临时工具变成长期包袱。

这次少见地做对了一半：把 AI 输出从“长文档”推向“可操作页面”，方向是对的。还没结算的另一半，是治理成本。

真正成熟的 AI 编程工具，不会只比谁的模型会写更多代码。它会比谁更会组织人的注意力。

这比生成速度更难，也更值钱。

回到开头那个反常点：让 Claude Code 输出 HTML，看上去像回到早年网页，实际是在把 AI 答案推向下一种形态。

Markdown 仍然会活得很好。它适合清楚、短、可维护的东西。

HTML 会吃掉另一块场景：复杂、临时、需要判断、需要互动的 AI 输出。

别把这看成格式复兴。格式只是表面。真正的变化是，AI 终于开始承认一件事：人类不是缺答案，人类缺能看懂答案的界面。