Claude Code写Markdown很厉害，但这不意味着所有任务都该输出Markdown。
Claude Code团队的Thariq最近分享了他的工作流变化：越来越多地要求Claude Code输出HTML而非Markdown。原因很简单——长篇Markdown规格文档生成容易，阅读困难。HTML能把同样的信息变成可导航、可视化、有时还可交互的产物。
核心原则：当输出是给人看的、而非在Git里逐行维护时，用HTML。
场景一：PR总结
别写：
"Summarize this PR in Markdown."
试试：
"Create a single self-contained HTML PR walkthrough. Render the important diff areas with inline annotations. Color-code findings by severity. Add a manual verification checklist at the bottom."
这样给评审者的是一个聚焦的评审界面，而非一堵子弹点墙。
场景二：方案对比
别写：
"Generate 5 implementation approaches as one HTML file."
试试用对比表格，每项方案展示：复杂度、迁移风险、测试影响、推荐场景。
这比五个垂直堆叠的Markdown章节好扫视得多。
但HTML并非总是更优
Thariq的准则是：Markdown是源文件，HTML是阅读界面。
具体指令示例：
"Create a self-contained HTML explainer for this feature. Audience: an engineer who has not seen this code before. Include a visual summary, annotated code snippets, risks, and a next-step checklist. Do not add external dependencies."
真正的洞察
关键不是"HTML比Markdown好"，而是AI生成的输出不必局限于纯文本。如果模型能生成有用的界面，就要那个界面。
对于跨多模型搭建Claude Code工作流的团队，EvoLink提供Claude及其他前沿模型的统一API接入。模板功能则可快速回复常见问题或存储代码片段复用。
