Skip to content
Back/Writing

HTML as the New Markdown

View in Graph
Updated 2026-05-27
2 min read
254 words

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 各适合什么场景?

Sources

Synthesized from 3 sources
  • AI Agent 时代的工作、算力与组织 — 十期播客深度综合Supporting source listed by this page.Whole pagemediumbody
  • 2026-05-26 Inside the 100-agent Software FactorySupporting source listed by this page.Whole pagemediumabsorb log
  • xiaoyuzhou-magazine-synthesis-v2Supporting source listed by this page.Whole pagemediumabsorb log

Evolution

1 event
  1. absorbed

    Derived from source material

    This page is currently synthesized from 3 sources.

    From AI Agent 时代的工作、算力与组织 — 十期播客深度综合, 2026-05-26 Inside the 100-agent Software Factory, xiaoyuzhou-magazine-synthesis-v2To HTML as the New Markdown
    Sources: raw/to-learn/xiaoyuzhou-magazine-synthesis-v2.md\ · raw/newsletters/Every/2026-05-26 Inside the 100-agent Software Factory.md · raw/to-learn/xiaoyuzhou-magazine-synthesis-v2.md

Linked from