AnthropicエンジニアがAI出力にHTMLを推奨。Markdownの限界を主張

📖 この記事で分かること

• AnthropicエンジニアがHTML推奨を主張した経緯と内容
• HTMLがMarkdownより優れるとされる5つのユースケース
• トークンコスト・セキュリティ等のトレードオフ
• 個人見解か公式発表かの位置づけ

💡 知っておきたい用語

• Claude Code:Anthropicが提供するコマンドライン型のAIコーディングエージェント
• アーティファクト:AIが生成する独立した成果物(HTMLファイルなど)
• トークン:AIモデルが処理するテキストの最小単位。料金や処理時間に直結

最終更新日: 2026年5月25日

▶ 公式ページ

• The unreasonable effectiveness of HTML — examples(20種のサンプル集)(GitHub Pages)
• Simon Willisonによる紹介記事(Simon Willison’s Weblog)

HTML推奨論の概要

この記事のポイント

• Anthropic Claude Code チームのThariq Shihipar 氏が2026年5月8日、AIエージェントの出力フォーマットとしてHTMLをMarkdownの代替に推す投稿を公開しました(2026年5月時点)。
• 投稿はX上で4.4M超のビューを集め、Simon Willison 氏も自身のMarkdown既定を再考すると表明しました(2026年5月時点)。
• ただしAnthropicの公式方針発表ではなく、Claude Code チームのエンジニア個人の見解で、現場での採用が広がっているという位置づけです(2026年5月時点)。

Thariq Shihipar 氏は2026年5月8日、X(旧Twitter)で「Using Claude Code: The Unreasonable Effectiveness of HTML(Claude Code を使う:HTMLの不合理なまでの有効性)」と題した記事を投稿しました。同氏はAnthropic Claude Code チームのエンジニア(報道によってはエンジニアリングリードと記載)で、AIエージェントの出力フォーマットとしてMarkdownよりHTMLが優れている、と主張しています。

Claude Code 開発の現場で実際にHTML出力への切り替えが進んでいる、というのが趣旨です。本人は20種類の自己完結したHTMLサンプルを集めたコンパニオンサイト(thariqs.github.io/html-effectiveness)を公開し、Markdown では難しいユースケースを具体的に示しました。

Claude CodeやAIエージェントの最新機能については、以下の記事で詳しく解説しています:

なぜMarkdownが「限界」なのか

Shihipar 氏は、Markdownが事実上AIエージェントの共通言語になってきた背景を認めた上で、エージェントが高機能化するにつれ Markdown が制約になり始めた と指摘しています。要点は以下の2点です。

第一に、ユーザーがAI生成のドキュメントを 自分で編集しなくなった こと。生成物はそのまま仕様書・参照ファイル・ブレストの素材として使われ、次のClaude セッションに渡されるだけになりつつあります。Markdownの最大の利点である「人間が手で編集しやすい」点が活きなくなる一方で、表現力の制約だけが残ります。

第二に、Markdownは100行を超えると読まれなくなる こと。Shihipar 氏は1,000行規模のMarkdown計画書を自分でも読まなくなり、同僚にも読ませられないと述べています。

HTMLが提供する情報密度

Shihipar 氏は「Claude が読める情報のうち、HTMLで効率的に表現できないものはほぼない」と主張します。HTMLが提供する表現の幅は、Markdownと比較すると次のような差があります。

コンパニオンサイトでは、3つのコード実装案の横並び比較、4種類の空状態UIのモックアップ、タイムラインとデータフロー図とリスク表を含む実装計画書など、20の具体例が公開されています。

HTMLによる動画生成など、AIとHTMLの連携が進む事例については以下の記事で詳しく解説しています:

5つの代表的ユースケース

Shihipar 氏は記事の中で、HTMLが特に効果的な5つの用途を挙げています。

1. 仕様・計画・探索:複数アプローチを1ファイル内のグリッドに並べて横並び比較できる。「6つの異なるオンボーディング画面案を1つのHTMLにグリッドで並べて、トレードオフを各案にラベル付けして」のようなプロンプトが推奨されます。

2. コードレビュー:差分のレンダリング、行内の注釈、深刻度別の色分け、モジュール構造の図示が可能。GitHub の標準差分ビューより読みやすいケースが多いとされます。

3. デザイン・プロトタイプ:実際のアニメーションを動かして調整できるサンドボックス的なHTMLを生成し、決まったパラメータをエクスポートして本番実装に渡せます。

4. レポート・調査・学習:SVG図、注釈付きコード、構造化された読み体験を1つのファイルにまとめられます。Claude Code はリポジトリ・git履歴・MCP接続(Slack等)を読み込んで合成できる点が強みです。

5. カスタム編集UI:テキスト指示が難しいタスク(チケットの並び替え、フィーチャーフラグ編集、プロンプトチューニング等)向けに、使い捨てのHTMLエディタを生成。最後に「マークダウンとしてコピー」「JSONとしてコピー」ボタンで結果をテキストに戻す、というパターンが提示されています。

トレードオフと反論

この主張には批判的な見方も出ています。Medium 上の反論記事「The Unreasonable Ineffectiveness of HTML」は、以下の懸念点を整理しています。

トークンコスト:HTMLはMarkdownより2〜4倍生成が遅く、トークン使用量も多くなります。Shihipar 氏自身は「100万トークンのコンテキストウィンドウ時代には軽微」としますが、批判側は「対話的なAIワークフローでは数十秒〜分単位の待ちは致命的で、Anthropic のトークン消費型課金モデルとの利益相反の指摘もある」と述べています。

バージョン管理:HTMLの差分はノイズが多く、git でのレビュー性が下がります。Shihipar 氏もこれが最大のデメリットだと認めています。

ソースの可読性:Markdownは生のテキストでも構造が明快ですが、HTMLは生コードを読むのが苦痛で、レンダリング前提になります。

セキュリティ:AI生成のJavaScriptを実行することで、XSS や情報漏えいのリスクが増加。HTMLを下流のパイプライン(パーサ・スクレイパ・RAG)で扱う場合は、Markdownと同じ信頼度では扱えないという指摘もあります。

共有のコスト:Markdownは GitHub、Slack、Notion などでネイティブにレンダリングされますが、リッチなHTMLはS3 などのホスティングが必要になることが多く、権限管理の負担が増えます。

編集部の見方

位置づけは「個人の主張」:本記事の主張は Anthropic の公式プロダクト方針ではなく、Claude Code チームのエンジニア個人の見解です。Anthropic からプレスリリースが出ているわけではないため、「AnthropicがMarkdownをやめてHTMLに移行する」と受け取るのは誤りです。同社プロダクト内部での標準採用が広がっているという報道はあるものの、ユーザー側に強制される話ではありません。

有効領域は限定的:ダイアグラム・モックアップ・横並び比較・使い捨てUIといった「視覚情報が本質のタスク」では明確な優位があります。一方で、シンプルなテキスト指示、コード生成本体、git で履歴管理したいドキュメントでは Markdown の方が依然合理的です。両者は対立というより「使い分け」の問題です。

運用上の判断軸:導入を検討する場合、(1) AI出力をそのまま次のセッションに渡すフローが多いか、(2) ビジュアル比較・プロトタイプ評価が業務の中心か、(3) トークン消費の増加を吸収できる予算と速度許容度があるか、を確認するのが現実的です。Shihipar 氏自身も「いきなり /html のような複雑なスキルを作らず、まず『HTMLファイルとして作って』と頼むことから始めるべき」と推奨しています。

Claude Code 固有の文脈:この主張は主にClaude Code(コードベースやMCPに接続できるエージェント)を前提にしており、Claude.ai のチャット画面で同じ効果が得られるわけではありません。コードベース全体の合成が必要なレポート生成では Claude Code の優位性が大きい一方、ブラウザ単体のチャット利用では恩恵が限定的です。

まとめ

よくある質問

Q: これはAnthropicの公式発表ですか?

A: 公式のプロダクト発表やプレスリリースではなく、Anthropic Claude Code チームに所属するエンジニアの個人ブログ投稿(X上の長文)です。ただし投稿者が現役の開発リードであり、社内で同様の慣行が広まっているとの記述があるため、社内文化を反映した発信ではあります。

Q: 普段のClaude チャットでも試せますか?

A: 試せます。プロンプトで「HTMLファイルとして作って」「HTMLアーティファクトで」と指示するだけで、Claude はSVG図や折りたたみセクションを含むHTMLを生成します。ただしClaude Code のようにリポジトリ全体を読み込ませる用途では、CLI版のほうが効果が大きくなります。

Q: Markdownはもう使わないほうがいいですか?

A: 用途次第です。バージョン管理・テキスト中心のドキュメント・Slack や Notion での共有が前提なら Markdown のままが合理的です。視覚的な比較・モックアップ・使い捨て編集UI・複雑な仕様書ではHTMLが有利、という整理になります。

まとめ

AIエージェントの出力フォーマットをMarkdownからHTMLに切り替える、というAnthropicエンジニア発の提案がX上で4.4M超のビューを集め、Simon Willison 氏も既定の見直しを表明する展開となりました(2026年5月時点)。視覚情報が本質のタスクでは情報密度・共有性・双方向性で大きな利点がある一方、トークンコスト・バージョン管理・セキュリティのトレードオフは無視できません。Anthropic の公式方針ではなく、個別のユースケースで両方を使い分ける判断軸が現実的です。

【用語解説】

• Claude Code: Anthropicが提供するターミナル型AIコーディングエージェント。ファイルシステム・git・MCP経由の外部サービスを横断して読み込み・編集できる。
• MCP【エムシーピー】: Model Context Protocol の略。AIモデルが外部データソース(Slack、データベース、ファイル等)に標準化された方法で接続する仕組み。
• アーティファクト: AIが生成する独立した成果物。Claude では会話と分離されたファイルやコードブロックとして扱われる。

引用元:

• [1] The unreasonable effectiveness of HTML – examples(コンパニオンサイト・20種のサンプル)(GitHub Pages・一次情報)
• [2] Using Claude Code: The Unreasonable Effectiveness of HTML(Simon Willisonによる紹介)(Simon Willison’s Weblog)
• [3] The Unreasonable Effectiveness of HTML in Claude Code(詳細解説)(ExplainX Blog)
• [4] The Unreasonable Ineffectiveness of HTML(反論記事)(Medium / Kurtis Redux)

この記事について: AI 支援で執筆、編集部が事実確認・編集しています。誤りや追加情報があれば Contact よりお知らせください。