Markdown → HTML：AI 输出正在从"文档"进化成"界面"

过去几年，Markdown 几乎成了 AI Agent 的"标配"。不管是 ChatGPT、Claude、Cursor 还是 Copilot，默认输出格式都是 # 标题、- 列表、`代码`。

但最近，Claude Code 团队的工程师 Thariq Shihipar（@trq212）发了一篇长文，提出了一个很有冲击力的观点：

Markdown 已经越来越限制 Agent 的表达能力。HTML 才是 Agent 时代人与 AI 协作的更优格式。

他甚至说，Claude Code 团队的人已经开始集体转向 HTML 了。

这听起来有点反直觉。Markdown 用了这么多年，怎么说换就换？但仔细读下去，你会发现一个关键前提正在发生变化——而这个变化，可能会重新定义 AI 时代"文档"的含义。

一、Markdown 为什么突然"不够用了"

这不是 Markdown 变差了。而是 Agent 变强了。

过去的 AI 只能回答问题、写段文字、输出个表格——Markdown 足够。但现在的 Claude、GPT-5.5 已经开始：

• 1 读取整个代码库
• 2 做系统设计
• 3 写 PR Review
• 4 生成架构图
• 5 做产品方案
• 6 生成交互原型
• 7 分析 Git 历史
• 8 理解 Slack / Linear / MCP

问题来了：这些复杂信息，最后却被塞进 Markdown 里——用 ## Architecture 做标题，用 User -> API -> Queue -> Worker 做架构图，甚至用 ████░░░░░ 这种 ASCII 图来表达进度。

这本质上其实就是：AI 的表达能力，已经超过 Markdown 这个"容器"了。 就像把一辆跑车塞进自行车道——不是车不行，是路太窄。

二、一个关键前提正在变化

Thariq 在文章里提到一句很关键的话：

这是整个事情的核心。

过去：

• 人类写 Markdown
• 人类改 Markdown
• 人类维护 Markdown

所以"易编辑"是核心优势。

但现在：

• Claude 写
• Agent 改
• AI 维护
• 人类更多只是阅读和决策

Markdown 最大的优势——“易编辑”——其实正在消失。

三、HTML 真正强的，不是"网页"

很多人看到 HTML 会下意识想到：前端、浏览器、网页开发。但这次大家重新看待 HTML，其实是因为：HTML 是目前最强的"信息表达协议"。

它天然拥有：

这意味着：Agent 输出的，不再只是"文档"，而是一个轻量级应用（Mini App）。

四、HTML 的六大核心优势

Thariq 把 HTML 的优势拆解得很清楚：

1. 信息密度爆炸

HTML 能承载表格、CSS、SVG、Canvas、JS 交互——几乎 Claude 能理解的任何信息都能高效呈现。不用再忍受 Unicode 模拟颜色或 ASCII 图的尴尬。

2. 可读性大幅提升

Thariq 的原话："超过 100 行的 Markdown 我基本不看了。"

但 HTML 可以：标签页切换、SVG 插图、可折叠模块、双栏布局、响应式适配——长文档也能轻松读完。

3. 分享极度方便

Markdown 只能当附件发，对方还要找工具打开。HTML 上传 S3 后直接发链接，浏览器原生打开。“别人真正去阅读的概率会大幅提升。”

4. 双向交互能力

Markdown 完全做不到：滑块调参、拖拽排序、实时预览、一键"Copy as Prompt"贴回 Claude Code。HTML 是动态编辑界面，真正实现人机闭环协作。

5. 数据摄入更强

Claude Code 能读取代码库、Slack、Linear、Git 历史等多源上下文，直接生成结构化 HTML 报告。

6. 愉悦感

“用 Claude 做 HTML 本身就是一件极其好玩的事。“更有参与感，更有创造感。

五、HTML 也有一堆问题

Thariq 没有一味吹捧，很诚实地列出了 HTML 路线的缺点：

关于版本控制，Thariq 说这是 “honestly one of the biggest downsides”。Markdown diff 一目了然（+ add section），HTML diff 却是 + <div class="flex gap-2 px-4">，可读性差很多。

关于审美，他的解决方案是：先让 Claude 扫描你的代码库，生成一个专属的 Design System HTML 文件，之后把这个文件作为参考资料丢给 Claude，让它在生成其他 HTML 页面时"照猫画虎”，保持风格高度一致。

六、真正重要的变化：从"文档"到"界面”

很多人容易误解成 “HTML vs Markdown” 的格式之争。但其实不是。

真正的变化是：AI 输出，正在从"文本"进化成"界面"。

过去：

Agent → 文档（Markdown）→ 人类

未来：

Agent → 可交互 Artifact（HTML）→ 人类

这本质上是：“软件界面生成"正在替代"文档生成”。

而 HTML，刚好是今天最成熟、最通用、最低成本的运行时——浏览器是全球最大的 Runtime。

七、Markdown 不会死，但会退化成"源码层"

Thariq 说他"几乎完全不用 Markdown 了"，但这不代表 Markdown 会消失。更可能的未来是分层：

Markdown 会越来越像 .md、.txt、.yaml——中间数据格式，而不是最终阅读格式。

就像 JSX 不再是最终 UI、AST 不再给人看、SQL 不是最终产品——Markdown 可能也会变成 Agent 内部通信格式。

真正给人看的：会越来越 HTML 化。

• ←上一篇
• 下一篇→