文章
文章
当前位置：首页>文章>使用指南>HTML 完胜 Markdown？Anthropic 开源案例，看懂 AI 文档新范式

HTML 完胜 Markdown？Anthropic 开源案例，看懂 AI 文档新范式

文本是《AI咨询（共169篇）》专题的第 169 篇。阅读本文前，建议先阅读前面的文章：

你有没有过这种体验？让 Claude Code 生成一个设计色板，它却用 ASCII 字符拼出一排灰扑扑的方块，hex 值标得很准，但那堆灰色点阵图案，根本看不出是个啥。

就在最近，Anthropic 的工程大佬 Thariq Shihipar 发了一篇长文，标题叫「HTML 好用得离谱」，直接引爆了开发者圈。他说自己已经几乎不用 Markdown 了，全部切换成让 Claude Code 生成 HTML。而且不只他一个人，Claude Code 团队里越来越多的人都在这么干。

HTML 完胜 Markdown？Anthropic 开源案例，看懂 AI 文档新范式

统治了开发者世界十年的 Markdown，难道就要被自家人抛弃了？

一、这位大佬是谁？敢叫板十年行业标准

Thariq Shihipar 可不是一般的工程师：

  • MIT Media Lab 出身，顶级技术背景

  • 开了五年游戏公司，融了 1700 万美元，实战经验拉满

  • 加入 Anthropic 的理由很特别，叫「AI psychosis」（AI 精神病）—— 他坚信 Claude Code 就是软件开发的未来，不来不行

他进了 Claude Code 团队后，同时管着工程、内容和用户反馈三条线。期间做的最有名的功能是AskUserQuestion，让 Claude 在信息不够时主动问问题，而不是瞎猜。他把这个叫「解除模型的束缚」，让 AI 释放本来就有的能力。

这次，他把自己和团队用 Claude Code 生成的20 个 HTML 文件全部开源在 GitHub Pages 上，按用途分成九大类。每一个都是单独的 HTML 文件，浏览器打开就能用。

项目地址：https://thariqs.github.io/html-effectiveness/#code-review

二、三个场景，让你秒懂 HTML 比 Markdown 强在哪

1️⃣ 代码审查：比 GitHub 的 diff 更好用

让 Claude Code 审查一个 PR，生成的 HTML 页面包含：

  • 完整的 diff 渲染，每段改动旁有内联注释

  • 注释按严重程度颜色编码：红色 = Blocking 级问题，黄色 = 值得关注，绿色 = 安全

  • 顶部风险地图（Risk Map），六个被修改文件用不同颜色标注风险等级，一眼看出重点

  • 底部自动生成修复建议清单

Thariq 说他现在每次提 PR 都附带一个 HTML 的代码讲解页，比 GitHub 默认的 diff 视图好用得多。因为代码的 diff 是空间信息，Markdown 把它压平了，HTML 能把它还原回来。

2️⃣ 交互式教程：一致性哈希，一个环搞定

让 Claude 解释技术概念，Markdown 只能输出线性文字，但 HTML 能做交互：

  • 页面上画一个环，4 个节点、32 个 key 分布在环上

  • 每个节点用颜色标注管辖的弧段

  • 可点击「加一个节点」或「删一个节点」，实时看到 key 的重新分配

  • 旁边有对比表，hash mod N vs 一致性哈希，指标清晰

  • 底部是悬停高亮的术语表

同样内容用 Markdown 写，大概是两页干巴巴文字加一张 ASCII 画的圆圈。你选哪个？

3️⃣ 用完即弃的编辑器：拖完就扔，扔前导出

处理 24 个工单排序？让 Claude Code 生成 HTML 文件：

  • 每个工单是一张可拖拽的卡片，在「Now / Next / Later / Cut」四列间拖动

  • Claude 先用自己的判断预排序，你只需微调

  • 调完点底部「Copy as markdown」按钮，导出最终顺序

微调系统 prompt 也一样：生成左右对照编辑器，左边可编辑 prompt 并高亮变量槽位，右边实时渲染三个样例输入，还有字符 /token 计数器。

Thariq 给这种玩法起了个名字，叫 「throwaway editor」（用完即弃的编辑器）。更关键的是「双向交互」——HTML 文档不再只读，你可以在页面里操作，调完后导出结果粘回 Claude Code 继续干活。人→AI→HTML→人操作→导出→AI，闭环了。

AI 生成的不再是「文档」，而是「工具」。

三、其他场景速览：HTML 能做的，Markdown 想都不敢想

场景 HTML 能做什么 Markdown 只能做什么
周报 配小图表和彩色时间线，经理一眼扫完 纯文字罗列，重点不突出
实施计划 时间线里程碑、数据流图、内联原型图、风险表，全在一个页面 枯燥说明书，看不出优先级
设计系统 读取代码库，把颜色变量渲染成色板，组件尺寸、状态、变体铺在表上 文字描述颜色和尺寸，想象空间大
动画原型 按钮点击动画 + 缓动曲线滑块，调完参数一键复制回代码 用文字描述动画，理解成本高
幻灯片 箭头键翻页，一个 HTML 文件就是一套演示文稿 静态文本，无法直接演示

四、为什么现在是 HTML 的时代？两个核心变化

Thariq 的判断建立在两个关键变化上：

  1. AI Agent 输出越来越复杂：一份超过 100 行的 Markdown 文件，他坦言自己读不下去，团队其他人也一样。

  2. 人们越来越少亲自编辑文件：规范文档、参考资料、头脑风暴输出，大多数时候让 Claude 来改。Markdown 最大优势「易编辑」，被架空了。

更重要的是：

  • Markdown 里颜色用方块字符估测，图表用 ASCII 画线框，代码 diff 只能用 + 和 - 标记

  • HTML 能装表格、CSS 设计 token、SVG 插图、交互组件、Canvas 空间数据

  • 只要是 Claude 能理解的信息，几乎没有什么是 HTML 表达不了的

还有个容易忽略的好处：分享。Markdown 文件大多数浏览器原生渲染效果不好，只能当附件塞进邮件。HTML 传到 S3 上就有链接，同事在哪里都能打开。

五、HTML 的缺点与未来：不是取代，而是迭代

当然，HTML 也不是没毛病：

  • 生成时间比 Markdown 慢 2 到 4 倍

  • 版本控制的 diff 乱得没法看

  • 确实更费 token

但 Thariq 的观点一针见血：你真的会去读 HTML 生成的东西，而 Markdown 的长文档，大概率划两下就关了。读了 vs 没读，这个差距可比 token 效率大多了。

说白了，当瓶颈从 token 数量变成了人的注意力，格式的选择逻辑就彻底反转了。

Markdown 不会消失，就像命令行不会消失一样。但它的统治地位，可能真的到头了。至少，Anthropic 自家人已经用脚投了票。

写在最后

十年前，Markdown 因为简单易写，成为开发者的标配。但现在，当 AI 成为我们的主要写作助手，格式的选择标准已经变了 —— 从「人写得爽」变成了「人看得爽」。

HTML 的爆火，不是技术的倒退，而是 AI 时代的必然进化。它让 AI 生成的内容不再是冷冰冰的文本，而是有温度、可交互、能解决实际问题的工具。

你准备好和 Anthropic 团队一起，扔掉 Markdown，拥抱 HTML 了吗？

欢迎关注[一步API] https://yibuapi.com ，我们还会持续分享更多AI咨询、AI工具、实战经验、踩坑记录，助力你高效玩转AI开发、避开行业弯路。

HTML 完胜 Markdown？Anthropic 开源案例，看懂 AI 文档新范式

想了解更多细节、获取专属支持，可添加 客服微信：xuexiv5876 \ YibuDev，随时咨询交流～

AgentAI工具AI漫剧claudeClaude CodeGemini 3.1 ProHTMLMarkdownOpenClaw
使用指南

OpenAI首个GPT-5级推理语音模型来了，语音交互正式进入"听与做"时代！

2026-5-9 8:33:52

使用指南

教你如何解决 OpenClaw 安装飞书插件失败的问题

2026-3-11 19:15:03

❯
搜索

  • 扫码打开当前页

返回顶部