现在 AI 界主流使用的 Markdown 文件格式有可能被淘汰？ Anthropic Claude Code 团队核心工程师 Thariq Shihipar（@trq212）于 5 月 9 日在 X 上发表了一篇题为「Using Claude Code： The Unreasonable Effectiveness of HTML」的长文，短短数小时内浏览量突破 200 万，在技术社群中掀起一波关于「AI Agent 时代该用什麽格式输出」的热烈讨论。 Thariq 在文中大胆主张：与 AI 协作时，应该用 HTML 取代 Markdown 作为主要输出格式。
Thariq Shihipar 并非一般工程师。 他是Anthropic Claude Code团队的核心成员，几乎所有Claude Code的重大功能更新都由他在X上首发。 在加入Anthropic之前，他的履历相当精彩：MIT Media Lab出身、曾创办游戏公司并在Y Combinator W20批次获得1700万美元融资。 他加入 Anthropic 的理由也颇有意思——用他自己的话说叫「AI psychosis」，他深信 Claude Code 就是软件开发的未来。 Claude Code 之父 Boris Cherny 的招人标准是「ex-founder， high agency」（创过业、执行力强），Thariq 正好两条都中。
进入Claude Code团队后，他同时负责工程、内容与用户反馈三条线，其中最知名的贡献是AskUserQuestion功能——让Claude在信息不足时主动提问，而不是胡乱猜测。 今年3月，他写了一篇关于Claude Code内部如何使用Skills的长文，透露Anthropic内部有数百个活跃Skills在运行，远比外界想象的多。
Claude Code 核心工程师呼吁：别再写 Markdown 了，用 HTML 吧
Thariq 坦言，Markdown 曾是好工具，简单、轻量、跨平台、适合版本控制，Claude 甚至能在 Markdown 里用 ASCII 码画出像样的图表。 但随着 AI Agent 能力飞跃，Markdown 的瓶颈越来越明显：
文件太长无人读：「超过 100 行的 Markdown 文件我基本不会去读，更别说让团队其他人读了。」Thariq 直言。
信息表达力不足： 当Claude Code想展示一组设计色板时，它在 Markdown 里只能憋出 ASCII 字符拼成的灰扑扑方块：Hex 色码标得很准，但视觉上根本无法辨识。 同一份信息换成 HTML 输出后，变成清晰可辨的彩色色块，一目了然。
分享麻烦： Markdown 文件无法在浏览器中直接渲染，只能当作附件寄送。 HTML 文件上传到 S3 后分享链接，任何人在任何设备上都能直接开启。
最大优势正在消失： Markdown 最大的优点是「人好」，但随着 AI 越强，用户越来越少手动这些文件，都是让 AI 去修改。 这个优势基本上已经失效。
为什么是 HTML？
Thariq 从五个面向论证 HTML 的优势：
信息密度。 HTML 能承载的信息远比 Markdown 丰富。 除了基本的标题与格式化，HTML 还能表达：表格数据（table）、设计资料（CSS）、插图（SVG）、代码片段（script 标签）、互动元素（JavaScript）、工作流程图、空间数据（绝对定位 + canvas）以及图片。 Thariq 甚至说：「几乎没有什么信息是 Claude 能读懂但 HTML 表达不了的。」
视觉清晰度与可读性。 Claude 可以用 Tab 分组、插图辅助、超链接导航，把 HTML 文件的结构组织得更容易浏览，甚至可以做成响应式设计。
方便分享。 HTML 文件上传后即可分享链接，同事不用安装任何工具就能在浏览器中阅读。
双向互动。 这是 HTML 最杀手级的应用，你可以在文件上加滑杆调整设计参数、加按钮将调整复制成 Prompt 贴回 Claude Code，甚至让文件变成一个可操作的 Playground。
数据摄入能力。 选择 Claude Code（而非 Claude.ai 或 Claude Design）来生成 HTML，最大的原因是 Claude Code 能摄入的上下文多得多——文件系统、MCP 工具（Slack、Linear）、浏览器、Git 历史等。
实战：五大场景与 20 个开源范例
Thariq 将自己和团队用 Claude Code 生成的 20 个 HTML 文件全部开源在 GitHub Pages（thariqs.github.io/html-effectiveness），按用途分为九大分类，以下是最核心的五个场景：
规格规划与探索。 不再写一份简单的 Markdown 方案，而是生成一整组 HTML 文件：先让 Claude Code 针对不同选项进行脑力激激盪，再深入展开做 Mockup，最后写实施方案。 验证 Agent 读入这些 HTML 后，对需求的上下文理解也会更全面。
PR 总结。 与其叫 Claude「用 Markdown 总结这个 PR」，不如叫它「生成一份自包含的 HTML PR 导览，用内嵌注解渲染重要 Diff 区域，按严重程度用颜色标记，底部加上手动验证清单」。 这给审查者的是一个聚焦的审查界面，而不是一堵项目符号墙。
代码审查与理解： 用 HTML 渲染代码差异，提升代码审查效果。
设计与原型互动：HTML 可以快速勾勒设计图、展示布局与互动效果，甚至加上参数调整滑杆。
输出清晰易读的报告：将复杂分析结果做成可导航的 HTML 报告。
观点交锋：HTML 真的能取代 Markdown 吗？
当然，这并非一面倒的支持。 一些开发者指出，Markdown 在轻量快速记录、Git 版本控制差异比对、以及纯文字便携性方面仍有不可取代的优势。 也有观点认为，这更像是「工具选择」的问题：输出给人看的时候用 HTML，需要逐行维护的规格文件继续用 Markdown，两者各有适用场景。 值得注意的是，就在几个月前，Cloudflare 才推出了「Markdown for Agents」功能，从源头将HTML网页内容转换为更适合AI爬虫的Markdown格式，这说明即使在同一波AI Agent 浪潮中，Markdown与HTML各有其无可取代的位置。
如何开始？
Thariq 建议不要急着做一个「always respond in HTML」的 Skill。 关键是理解你想让这个 Artifact 做什么、打算怎么用。 直接从简单的 Prompt 开始：「帮我做一个 HTML 文件」「做一个 HTML artifact」，在不同场景下慢慢摸索用法。 随着经验积累，自然会找到最适合自己的工作流程。
