Claude 工程师力推 HTML 取代 Markdown，你怎么看？

温馨提示：若页面不能正常显示数学公式和代码，请阅读原文获得更好的阅读体验。

作者：艾米丽 (连享会)
邮箱：lianxhcn@163.com

• Title: Claude 工程师力推 HTML 取代 Markdown，你怎么看？
• Keywords: Claude Code, HTML, Markdown, AI Agent, 输出格式, Thariq Shihipar, Anthropic, Quarto, Jupyter
• 摘要：Anthropic Claude Code 工程主管 Thariq Shihipar 近期发文，主张用 HTML 取代 Markdown 作为 AI Agent 的默认输出格式，帖子 16 小时内获超 440 万次浏览。本文梳理其核心论点、社区的反驳意见，并针对不同使用场景给出实操建议。

1. 写在前面

2026 年 5 月初，一篇 X（前 Twitter）上的帖子在 AI 开发者社区引发广泛讨论。Anthropic Claude Code 团队工程主管 Thariq Shihipar 写道：

"HTML is the new markdown. I've stopped writing markdown files for almost everything and switched to using Claude Code to generate HTML for me."

帖子发布 16 小时内，获得超过 440 万次浏览、8,200 个点赞、15,700 次收藏，随即在 Hacker News、Reddit、YouTube 等平台引发热议。Simon Willison（知名开发者博主）公开表示，这篇文章让他重新审视了自己沿用三年的 Markdown 输出习惯。

图 1：Claude Code 工程主管 Thariq Shihipar（来源：DigitalToday / LinkedIn）

这场争论的核心并不复杂：当 AI 替我们生成内容时，Markdown 还是 HTML，哪种格式更适合作为输出物？但它背后触及的是一个更实际的问题：随着 AI Agent 的输出越来越长、越来越复杂，我们理解和使用这些输出的方式，是不是也该跟着改变？

提前说明：这不是 Claude Code 官方宣布废弃 Markdown。官方文档仍把CLAUDE.md作为项目记忆和规则文件的标准格式。Thariq 的观点代表的是他个人在 AI Agent输出场景下的实践判断，而非平台层面的格式迁移。

2. 背景：Markdown 如何成为 AI 的「默认语言」

Markdown 是一种轻量级纯文本标记语言，由 John Gruber 于 2004 年设计，目标是「易读易写的纯文本，能被转换为结构化 HTML」。它被广泛用于 GitHub README、技术博客、Obsidian / Typora 笔记，以及 Quarto.qmd、R Markdown.rmd、Jupyter Notebook 等学术写作工具。

Markdown 之所以成为 LLM 的默认输出格式，有其历史原因：在 GPT-4 时代，模型的上下文窗口只有 8,192 个 token，每个 token 都很珍贵。Markdown 比 HTML 节省大量 token，自然成为首选。

但 Thariq 指出，这一前提已发生根本性变化。Claude 的上下文窗口现在可以处理百万级 token，Agent 生成的规划文档、代码审查报告、技术规格说明，动辄数百行。在这个体量下，Markdown 的局限开始显现——不是因为它「变差了」，而是因为它本来就不是为这种体量和复杂度设计的。

图 3：Markdown 与 HTML 作为 AI 输出格式的核心差异（制图：连享会）

3. 提出者的论点：为什么是 HTML？

Thariq 的完整论证发表在 X 上，并配套了 20 个真实的示例文件，公开在 thariqs.github.io/html-effectiveness。他的核心论点分为五个维度。

图 2：HTML 与 Markdown 作为 AI Agent 输出格式的对比（来源：Pasquale Pillitteri）

3.1 信息密度：Markdown 到顶了

Markdown 能处理段落、列表、链接、代码块和简单表格，但止步于此。颜色、图表、流程图、SVG 图示、交互控件——这些都需要额外的渲染层或变通方案。

一个典型的尴尬例子：当你要求 Claude 在 Markdown 里「展示颜色」，它只能用 Unicode 字符近似模拟。HTML 则可以直接渲染色块。类似地，代码审查中的 diff 视图、数据流图、模块调用图，这些本质上是空间结构信息，Markdown 会把它们压平成线性文本；HTML 可以保留甚至增强这种空间关系。

3.2 长文档可读性：100 行是道坎

Thariq 直接承认：超过 100 行的 Markdown 文件，他自己也不会认真读完。这不是个人习惯问题，而是格式本身的局限——没有折叠、没有跳转、没有结构化导航，一长串文字只能靠滚动翻。

HTML 可以加入折叠面板、侧边目录、标签页切换、响应式布局。同样是一份 500 行的技术规格文档，HTML 版可以在桌面和手机上分别优化呈现方式，Markdown 版只能「一条到底」。

3.3 分享便利性：.md 文件要人打开

把一个.md文件发给同事，对方需要有专门的 Markdown 渲染工具（VS Code、Typora、Obsidian……）才能正常阅读。把一个.html文件发出去，任何人在任何设备上用浏览器打开即可。

这看起来是小事，但 Thariq 观察到：一份资料的实际阅读率，与打开它的成本成反比。格式越「开箱即用」，别人真正读它的概率越高。

3.4 双向交互：HTML 可以「动起来」

这是 Thariq 论点中最有新意的部分。HTML 不只是展示内容，还可以嵌入交互逻辑：

• 滑块（slider）用于调整参数，实时看参数变化对结果的影响；
• 可点击的选项卡，对比不同方案；
• 「复制为 Prompt」按钮，把当前界面状态直接转换为可粘贴回 Claude 的 prompt。

这让 AI 的输出从「一段文字」变成了「一个临时工作台」。用户不再只是被动阅读，而是可以在这个界面里继续探索和决策。

一位网友对这一点做了有意思的延伸：

当你引导模型向你提问时，这一点尤其重要。使用包含置信度、选项及其优缺点以及模型建议的富文本 HTML 表单提问，会引发比纯文本更深入的思考。即使只是简单地指定提供多个选项（不一定互斥）、允许评论和调整，也能促使模型的回答更有深度。

3.5 更深的参与感

Thariq 最后说了一句颇有意思的话：

"Using HTML makes me much more deeply involved in what Claude does. I was worried that not reading planning documents in detail would mean having to leave decisions to Claude, but now I understand what Claude is doing much better than before."

用 HTML 倒逼自己真正「看完」AI 的输出，而不是扫一眼就关掉——这反而让他对 AI 的决策过程理解得更深了。

温馨提示：若页面不能正常显示数学公式和代码，请阅读原文获得更好的阅读体验。