Claude Code寫Markdown很厲害，但這不意味著所有任務(wù)都該輸出Markdown。

Claude Code團(tuán)隊的Thariq最近分享了他的工作流變化：越來越多地要求Claude Code輸出HTML而非Markdown。原因很簡單——長篇Markdown規(guī)格文檔生成容易，閱讀困難。HTML能把同樣的信息變成可導(dǎo)航、可視化、有時還可交互的產(chǎn)物。

核心原則：當(dāng)輸出是給人看的、而非在Git里逐行維護(hù)時，用HTML。

場景一：PR總結(jié)

別寫：

"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."

試試用對比表格，每項方案展示：復(fù)雜度、遷移風(fēng)險、測試影響、推薦場景。

這比五個垂直堆疊的Markdown章節(jié)好掃視得多。

但HTML并非總是更優(yōu)

Thariq的準(zhǔn)則是：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."

真正的洞察

關(guān)鍵不是"HTML比Markdown好"，而是AI生成的輸出不必局限于純文本。如果模型能生成有用的界面，就要那個界面。

對于跨多模型搭建Claude Code工作流的團(tuán)隊，EvoLink提供Claude及其他前沿模型的統(tǒng)一API接入。模板功能則可快速回復(fù)常見問題或存儲代碼片段復(fù)用。