Markdown 文档为什么没人读?
用 Claude Code 工作时,规划文档、代码分析、调研摘要全部以 Markdown 堆积。内容足够,但一旦超过 100 行,屏幕上就只剩符号和缩进,人们往往只扫一眼开头就跳过去了。
Anthropic 的 Claude Code 工程师今年 5 月在博客上坦承了同样的事实:"HTML 是新的 Markdown。"他自己也不再读超过 100 行的 Markdown,转而以 HTML 接收结果。问题不在于文档不够,而在于生成速度已经超过了阅读速度。
一行 HTML 转换指令能改变什么?
一句提示词就够了:"把我的调研 Markdown 转成 HTML,顶部按频道做成标签页,内容按主题整理成卡片布局。"同样的内容重新排成标签页和卡片,无需滚动即可一目了然,与读 Markdown 相比理解速度明显不同。
布局、图表、表格,指定什么就输出什么。从"做成 HTML"一句话开始,逐步细化你想要的结构即可。
Playground 插件补充了什么?
静态 HTML 触不到的最后一环是交互——按按钮、拖滑块来探索的动态画面。单纯的转换请求很难做好这一点,因此 Anthropic 把它打包成了 Playground 插件。在 Claude Code 中执行 /plugin install playground@claude-plugins-official 一条命令即可安装,并内置了按问题类型划分的模板。
可视化代码库依赖关系时,模块会绘制成按颜色区分的节点图,通过分层预设按钮可以只聚焦想看的部分。附加在节点上的评论会转换成反馈提示词,粘贴到 Claude Code 中,就会针对该模块启动定向分析。
执行流程也一样。一个问题如何经过八个阶段变成答案,以动态图示呈现;点击问题预设,相应路径会被高亮。比阅读文字说明耗时更短,理解更深。
什么时候用 HTML,什么时候用文本?
全部以 HTML 接收会消耗多得多的 Token。标准很简单:需要用表格、图示、卡片来理解的完成品用 HTML;草稿、备忘、Agent 之间的数据这类中间产物保留文本,节省 Token。
多花 Token 仍然划算的原因很明确:AI 生成文档的速度已经超过了人类的理解速度。缩小这个差距,才是当下真正的生产力——不是把工作交给 AI 的能力,而是快速阅读并验证 AI 输出的能力。