使用 Claude Code：HTML 不讲道理的有效性

为什么使用 HTML？

有几件事让 HTML 比Markdown 更适合我现在用 Claude Code 做的工作。

信息密度

HTML 可以传达比 Markdown 丰富得多的信息。它当然可以做简单的文档结构，如标题和格式，但它还可以表示各种其他信息，例如表格数据、CSS 设计数据、SVG 插图、代码片段、交互、工作流、空间数据和图片。

在我看来，几乎没有 Claude 能读取的信息集是不能用 HTML 高效表示的。这使它成为模型向你在深度上传达信息的高效方式。

视觉清晰度和阅读便利性

随着 Claude 能够处理更复杂的工作，它也能编写越来越大的规格和计划。我发现自己往往不会真正阅读超过 100 行的 Markdown 文件，而且我当然也无法让我组织中的其他人去读它。

但 HTML 文档更容易阅读，因为 Claude 可以在视觉上组织结构，使其最适合通过标签页、插图和链接来导航。

分享便利性

Markdown 文件很难分享，因为大多数浏览器不能原生很好地渲染它们。但 HTML 文件可以轻松分享链接。你的规格、报告或 PR 描述以 HTML 形式呈现时，有人真正阅读的可能性要高得多。

双向交互

HTML 还可以让你与文档交互；例如，添加滑块或旋钮来调整设计，或允许你调整算法中的不同选项。你还可以将更改复制到提示中粘贴回 Claude Code。

数据摄取

使用 Claude Code 生成 HTML 文件的最大原因之一是 Claude Code 可以摄取的所有上下文，包括文件系统、MCP（如 Slack、Linear 等）、网络浏览器和 git 历史。

用例

规格、规划和探索

HTML 是 Claude 深入探索问题的丰富画布。当我开始处理一个问题时，我期望创建一个 HTML 文件网络，而不是简单的 Markdown 计划。

代码审查和理解

代码在 Markdown 文件中可能很难阅读，但使用 HTML，我们可以渲染差异、注释、流程图和模块。

设计和原型

Claude Design 基于 HTML，因为 HTML 在设计方面表现力极强。Claude 可以在 HTML 中勾勒设计，然后用你选择的语言编写。

报告、研究和学习

Claude Code 非常擅长综合多个数据源的信息并将其转换为可读的报告。

自定义编辑界面

有时很难纯粹在文本框中描述你想要什么。对于这个用例，我经常要求 Claude 为我正在处理的具体内容构建一个一次性的编辑器。

常见问题

效率不是更低吗？ 虽然 Markdown 通常使用更少的 token，但 HTML 增加的表现力以及更高的阅读可能性意味着整体上更好的输出。

你现在什么时候用 Markdown？ 老实说我已经几乎停止在所有事情上使用 Markdown 了。

这就是你替代规划的方式吗？ 我发现我倾向于为计划的不同部分/阶段拥有几个不同的 HTML 文件。

与 Claude 保持同步

我使用 HTML 而不是 Markdown 的真正原因是它帮助我感觉与 Claude 更加同步。HTML 结果正是我需要的。我现在比以往任何时候都感觉更与它同步。

本文由技术团队成员 Thariq Shihipar 撰写，表达了他在 Claude Code 中使用 HTML 文件的个人观点和偏好。