AIエージェントの出力はMarkdownよりHTMLが良い — Anthropicエンジニアが「100行超のMarkdownは読む気を失わせる」と指摘、議論に

6月25日、InfoQが「Anthropic Lead: HTML Increasingly Better Than Markdown at Keeping Humans Engaged in Agentic Loops」と題した記事を公開した。Claude CodeチームのエンジニアリングリードがAIエージェントの出力フォーマットとしてMarkdownよりHTMLを推奨する理由と、その実践的な活用パターンについて詳しく紹介されている。

「100行超のMarkdownは読みにくい」——現場からの問題提起

Claude Codeは、Anthropicが提供するターミナル上で動作するAIコーディングエージェントだ。そのエンジニアリングリードであるThariq Shihiparが、ブログ記事「Using Claude Code: The Unreasonable Effectiveness of HTML」を公開した。主張はシンプルだ。エージェントの出力フォーマットとして、MarkdownよりもHTMLの方が人間の関与を維持しやすい。

Shihiparはその背景をこう語っている。

エージェントがどんどん強力になるにつれて、Markdownはますます制約の多いフォーマットになってきた。100行を超えるMarkdownファイルは読むのが辛い。（中略）私はそれらのファイルを自分で編集することも減り、仕様書や参照ファイルとして使うことが増えている。

エージェントが長く複雑なワークフローで使われるほど、その出力も長大になる。その結果、人間は出力をろくにレビューせず「とりあえず承認」してしまう——これが品質・保守性・セキュリティのリスクにつながる、というのがShihiparの指摘だ。

特に人間の判断が不可欠な場面——目標設定、要件の精査、成果物のレビュー、誘導的な修正作業など——では、エージェントの出力フォーマットが人間の認知負荷を左右する。

HTMLをどう使うか：使い捨ての単一ファイルという発想

Shihiparが提案するのは、「使い捨ての単一HTMLファイル」として出力を生成させるパターンだ。MarkdownのようなプレーンテキストではなくHTMLにすることで、色、レイアウト、インタラクティブ要素を盛り込んだ、その場その目的に特化したワークスペースが作れる。

Shihiparが特に有効と考えるユースケースは以下の通りだ。

仕様策定・計画・探索
コードレビューと理解
インターフェース設計とプロトタイピング
データ探索・分析・可視化
カスタムUIが役立つあらゆる問題

具体例として、チケットのトリアージを高速化するために生成したHTMLのダッシュボード出力が公開されている。

PRレビュー用の出力例も公開されており、ターミナルをスクロールするよりも素早く内容を把握できる構造になっている。

これらの例はShihiparのコンパニオンサイトで確認できる。

賛否両論：Markdownの簡潔さを捨てるな、という声も

この提案はHacker News、Reddit、Mediumで広く議論を呼んだ。

賛成側では、Simon Willison（Django共同創設者）が自身の考えの変化をこう語っている。

GPT-4時代から、ほとんどのものをMarkdownで出力させるようにしていた。当時は8,192トークンの制限があり、HTMLよりMarkdownのトークン効率の高さが非常に価値を持っていた。Thariqの記事を読んで、特に出力に関しては考え直すきっかけになった。ClaudeにHTML形式で説明を求めると、SVGダイアグラム、インタラクティブなウィジェット、ページ内ナビゲーションなど、情報をより快適にナビゲートできるあらゆる工夫を盛り込んでくれる。

一方、反対意見も根強い。Markdownの代替としてHTMLを使うのは退歩だと主張する声は、以下の点を指摘する。

ソースの可読性が失われる（生のHTMLは人間が読む想定ではない）
セキュリティリスク（サニタイズされていないHTMLをブラウザで開くと、悪意あるスクリプトが実行されるXSSのリスクがある）
トークンコストの増大（MarkdownよりHTMLの方がトークンを消費する）
gitとの相性が悪い（差分が取りにくい）

なお、こうした議論を受けて、タスクに応じてHTML出力に自動切り替えするOSSのClaude Skill「html-artifacts」（Greg Dogum作）も登場している。

結局「適材適所」の話

Shihipar自身は、この議論を締めくくる言葉としてこう述べている。

私がMarkdownの代わりにHTMLを使う本当の理由は、Claudeとの関わりをより深く感じられるからだ。Claudeが多くを担うようになるにつれ、計画をあまり注意深く読まなくなっていることに気づいた。HTMLは、その選択をただ丸投げするのではなく、関与し続けるための手段になった。

モデルの性能向上とコンテキストウィンドウの拡大によってMarkdownのトークン効率面での優位は薄れつつあり、HTMLのリッチな表現力が選択肢として現実的になってきた背景がある。AIエージェントプラットフォーム各社も人間とエージェントのインターフェース改善に取り組んでおり、Googleが研究しているGenerative UI（プロンプトに応じてUIをその場で生成する技術）もその流れの一つだ。

詳細はAnthropic Lead: HTML Increasingly Better Than Markdown at Keeping Humans Engaged in Agentic Loopsを参照していただきたい。