HTML as the New Markdown
What it is
当 Agent 运行时间从几分钟变成几小时,Markdown 计划变得不可读,HTML 成为更丰富的沟通媒介。Clara Vo(Anthropic)提出这一判断:模型擅长生成 HTML,且人类更容易参与。
Why it matters
传统 Markdown 在短任务中表现良好,但在长时程 Agent 协作中存在局限:
- 千行 Markdown 难以滚动浏览和导航
- 无法包含 mockup、代码摘录、style guide 等富媒体
- 人类参与编辑的门槛较高
HTML 解决了这些问题:
- 滚动浏览比阅读千行 Markdown 更自然
- 可以包含 mockup、代码摘录、style guide、交互元素
- 可以生成一次性微型 UI 来编辑特定模块
Key points
- 模型擅长生成 HTML:HTML 的结构化标签与模型的输出模式天然契合
- 人类更容易参与:可视化编辑比纯文本编辑更直观
- Living Design System:用 HTML 文件表示 design system(颜色、typography、spacing、components),可以到处传递,新项目直接引用
- 可生成 component visualization page:让营销人员下载透明 PNG
- Agent work report:在多 agent 软件工厂中,HTML 可以把长期运行结果、截图、状态、diff 和可视化说明压缩成一个人类更容易审阅的页面。
Living Design System
用 HTML 文件表示 design system:
- 颜色、typography、spacing、components 全部结构化
- 可以到处传递,新项目直接引用
- 甚至可以生成 component visualization page,让非技术人员也能使用
验证的未来
- 测试验证不等于测试
- 验证可以是一套 rubric 配合 managed agent 和 outcomes
- 也可以是让 Claude 录一段视频展示它为你做了什么
Evidence across sources
| Source | Key Claim | Relevance |
|---|---|---|
| AI Agent 时代的工作、算力与组织 | Clara Vo: "HTML 是新的 Markdown" | 原始定义来源 |
| AI Agent 时代的工作、算力与组织 | 四步工作流:brainstorm HTML → HTML 计划文件 → HTML micro-app → HTML design system | 具体落地方法 |
| Inside the 100-agent Software Factory | Every treats HTML reports and interactive artifacts as a better medium for agent output than flat Markdown in some workflows. | 第二来源,推动本页从 candidate 走向 mature |
Open questions
- HTML 计划与 Markdown 计划的边界在哪里?什么场景适合 HTML,什么场景仍需要 Markdown?
- 如何防止 HTML 计划的"过度工程"——用复杂格式包装简单内容?
- 在 Agent 协作中,HTML 是给人看的还是给 Agent 看的?两者的需求是否冲突?
Prompts for witness
- 你最近一次与 Agent 协作的"计划文档"是什么格式?它有效吗?
- 如果你要设计一个 8 小时 Agent 任务的"计划文档",你会选择什么格式?
- 在你的工作流中,HTML 和 Markdown 各适合什么场景?