隨著 AI Coding 與 Agent 工具快速進化，工程師長年習慣使用的 Markdown，似乎開始出現侷限。近日，Anthropic Claude Code 團隊工程師 Thariq Shihipar 在 X 上發文表示，自己已逐漸停止以 Markdown 作為主要工作文件格式，轉而大量使用 HTML，並認為 HTML 更適合 AI 時代的人機協作方式。
AI 文件越來越長，Markdown 已不易閱讀
他指出，過去 Markdown 之所以流行，在於它簡單、輕量、容易編輯，也方便模型生成。但隨著 Claude Code 這類 AI 工具開始能撰寫大型規格文件、研究報告、程式碼分析與互動式原型後，Markdown 已越來越難承載這些內容。
Shihipar 直言，自己其實很少會完整閱讀超過 100 行的 Markdown 文件，更難期待團隊其他人願意仔細看完。相較之下，HTML 能透過更靈活的版面設計、色彩、圖解、互動元件與視覺階層，讓 AI 產生的內容真正變得「可閱讀」。
他認為，HTML 最大的優勢，在於幾乎所有 Claude 能理解的資訊，都能透過 HTML 有效呈現。從表格、流程圖、動畫、程式碼區塊，到 SVG 圖示、互動控制器甚至小型工具介面，都能直接整合在單一文件內。過去 AI 在 Markdown 裡常需要用 ASCII 圖形或 Unicode 字元硬湊視覺效果，但在 HTML 中，這些都能自然完成。
HTML 文件更容易分享，還能建立互動介面
另一個關鍵原因則是「分享」。Markdown 文件往往需要透過 GitHub、Notion 或特定編輯器閱讀，但 HTML 只要放上靜態網站或 S3，就能直接透過網址分享。Shihipar 認為，這大幅提高同事實際閱讀 AI 文件的意願。
他也提到，HTML 不只是更漂亮的文件格式，而是讓 AI 能直接生成「互動介面」。例如 Claude 可以建立帶有滑桿、按鈕與即時預覽功能的 Prototype，讓使用者直接調整動畫速度、修改 Prompt、重新排序任務或編輯 Feature Flag，最後再將結果匯出回 Claude Code 使用。
在實際工作流程上，他現在經常會先讓 Claude 生成多種 HTML 探索方案，再逐步延伸成 Mockup、設計稿與實作計畫，最後把這些 HTML 文件重新作為下一輪 Claude 的上下文。甚至連 Code Review，他也開始習慣附上一份 HTML 解說頁，協助其他工程師理解 PR 背後的設計邏輯與資料流。
Shihipar 認為，Claude Code 最大的價值之一，在於它能讀取大量上下文資料，包括本地程式碼、Git 歷史、Slack、Linear 與 MCP 工具，因此 AI 能把這些資訊整合後，轉化成更容易閱讀的 HTML 報告與視覺化文件。
從「自動化」回到「參與感」
儘管 HTML 的生成時間可能比 Markdown 長 2 到 4 倍，且在 Git 上的 Diff（版本比對）較為雜亂，但 Shihipar 認為這些代價是值得的。
「改用 HTML 後，我感覺自己與 AI 的協作更加緊密。」他強調，HTML 豐富的視覺反饋讓開發者不再只是單向接受 AI 的長篇大論，而是能真正參與到設計與決策的循環中。
Shihipar 建議使用者不需要安裝複雜的套件，只需在與 AI 對話時加入簡單的指令，例如：「請生成一個 HTML 檔案」或「以 HTML Artifact 形式呈現」。
請注意！留言要自負法律責任，相關案例層出不窮，請慎重發文！