Datawhaleの知識共有
著者：Thariq、Claude Codeチーム
一昨日、Claude CodeチームのThariqが「Using Claude Code: The Unreasonable Effectiveness of HTML」というタイトルの記事を公開しました。今やこの記事はXで爆発的な反響を呼び、780万人に閲覧され、2万人以上が保存しています！
この記事が爆発的に広まった理由は、直感に反するある事実にあります：
多くの人はAIを使う時、デフォルトでMarkdownを出力させます。計画書もMarkdown、要約もMarkdown、PRの説明もMarkdownです。
これは非常に理にかなっています。Markdownはシンプルで安定しており、編集しやすく、コードリポジトリにも馴染みます。長い間、MarkdownはAIと人間をつなぐ最も自然な成果物フォーマットでした。
しかしThariq氏は、今ではMarkdownではなく、Claude CodeにHTMLを出力させる傾向が強まっていると言います。
さらに興味深いのは、Claude Codeチームの他のメンバーも同様のことをしているのをよく見かけるようになったということです。
これには好奇心をそそられます：
Markdownは明らかにシンプルで安定し、編集しやすく、AI生成ドキュメントのデフォルトフォーマットです。なぜ最前線にいるClaude Codeチームのメンバーは、HTMLへと舵を切り始めたのでしょうか？
以下は、この記事の核心部分をまとめたものです。一読の価値ありです。
Claude CodeチームがMarkdownの使用を控え始めた理由
Markdownが壊れてしまったわけではありません。依然としてシンプルでポータブル、編集しやすく、README、説明ドキュメント、コードスニペット、軽量な記録には十分適しています。
Thariq氏も認めているように、Markdownはエージェントと人間がコミュニケーションする主流のフォーマットになっています。ClaudeはMarkdownでASCIIアートを描くことさえ得意です。
しかし、Claude Codeのユースケースが変わったのです。
以前、私たちがAIにMarkdownを書かせていたのは、それが編集しやすかったからです。人間がファイルを開き、数行を手動で調整し、見出しを変え、説明を一部削除する。そんなことが簡単でした。
しかしThariq氏は、今ではこうしたファイルを自分で直接編集することがほとんどなくなったことに気づきました。多くのMarkdownは手動で修正するためにあるのではなく、仕様書、参考資料、ブレインストーミングの結果、あるいは次の実行計画として存在しています。
本当に修正が必要な時も、自分でファイルを開いて少しずつ直すのではなく、代わりにClaudeに「ここを修正して」「あそこを書き直して」と指示を出すのです。
これにより、Markdownのコアな利点の一つが弱まりました。過去の問題は「このフォーマットは人間が編集しやすいか」でした。今の問題は「このフォーマットは人間がまだ読みたいと思うか、素早く理解できるか、それに基づいて判断を続けられるか」に変わったのです。
AI時代の真の問題：AIが書きすぎて、人間が読まなくなる
ここで本当に突いているのは、「HTMLとMarkdownのどちらが優れているか」といったフォーマット論争ではなく、もっと普遍的な問題です：AIは今、あまりにも多くのものを書けるようになってしまった。
以前はAIが書けないことを心配していました。今では、実際に書けるだけでなく、非常に完全な形で書けることが増えています。
実装計画書は数百行にもなり、PRの説明は背景、変更点、リスク、コードスニペットまですべて説明できます。技術レポートも、文脈、計画、データ、結論をすべて整理できます。
問題は、人間は本当にそれを読むのか？ ということです。
多くの人がAIを使う時、似たような経験をしたことがあるはずです。AIが一見完璧に見えるMarkdownを生成し、あなたはそれをざっと見て、大体問題なさそうだと思い、そのまま続行させる。
それは内容が必ずしも悪いからではなく、長すぎ、平板すぎ、文字の壁のように見えるからです。
Markdownの表現方法はリニア（直線的）です。見出しの下には段落があり、段落の下にはリストがあり、リストの下にはコードブロックがあります。短いうちは非常に明確ですが、長くなると人間の忍耐力が試されます。
つまり、核心的な問題は、AIがドキュメントを生成できるかどうかではなく、AIがこれほど多くのものを生成した後、人間がまだ読みたいと思うか、理解できるか、判断に参加するかどうかなのです。
HTMLとMarkdownの違い、それはAIの出力を読みやすく変える力
HTMLと聞くと、多くの人の第一印象は「これってウェブページでしょ？」というものかもしれません。
しかし、Thariq氏の言うHTMLとは、ウェブページを書けと言っているのではなく、すべてのドキュメントをウェブサイトにしろと言っているのでもありません。それはむしろ、Claude Codeに複雑なコンテンツを、より理解しやすいページに整理させるようなものです。
同じ実装計画書でも、Markdownで書かれれば、高い確率で延々と続く見出し、リスト、コードブロック、説明になります。全体像をつかむには、上から下まで読み進めなければなりません。
しかし、HTMLで書かれた場合、Claudeは異なる案をタブの中に入れたり、重要な流れを図に起こしたり、コードスニペットを脇に配置したり、結論を先頭に持ってきたり、詳細を折りたたんだりできます。
この時、あなたは「ひとつのドキュメントを読み終える」のではなく、すでに整理されたワークベンチを閲覧しているのです。
ワークベンチのようなHTMLの例
これこそが、HTMLのMarkdownと比較した核心的な違いです：単にテキストを載せるだけでなく、レイアウト、図示、インタラクション、視覚的な階層を表現できるのです。
Thariq氏が述べるように、HTMLがなければ、Claudeは時にMarkdownの中で「視覚化しようと懸命に努力」します。ASCII文字で図を描いたり、Unicode文字で色をシミュレートしたりするのです。
これは興味深いことですが、Markdown自体が複雑な視覚表現を担うのに適していないことの証左でもあります。ClaudeにMarkdown内で我慢させるよりも、直接HTMLを使って描かせた方が早いのです。
HTMLは必ずしもコンテンツをより正確にするとは限りませんが、コンテンツをより見やすく、理解しやすく、チェックしやすくすることは確かです。
HTMLは見るだけでなく、操作できる
しかし、Thariq氏の記事で最も興味深いのは、HTMLが読みやすいという点だけではありません。
本当に目を見張らせるのは：HTMLは即席の小さなツールになり得るということです。
つまり、Claude Codeは見るためのページを生成するだけではありません。操作したり、調整したり、選択したりするためのインターフェースを生成し、その結果を再びClaude Codeに返すことができるのです。
例えば、30個のLinearチケットの優先順位を並べ替えたいとします。チャット欄だけでこれを行うのは非常に煩わしいでしょう。「これを前に、あれを後ろに、これらは一旦やめて」と一つ一つ指示しなければなりません。
より自然な方法は、Claude CodeにHTMLのカンバンボードを直接生成させることです。ページには「Now」「Next」「Later」「Cut」の4列があり、各チケットはドラッグ可能なカードです。Claudeが最初に一版を作成し、あなたがドラッグ＆ドロップで調整し、最後にワンクリックでMarkdownにエクスポートします。
インタラクティブなHTMLカンバンボード
別の例として、システムプロンプトの調整があります。ClaudeはHTMLページを生成し、左側に編集可能なプロンプト、右側にサンプル入力とリアルタイムプレビュー、下部にトークン数とコピーボタンを配置できます。
この変化は重要です。HTMLはClaudeの出力を「あなたが読むのを待つドキュメント」から「操作可能なインターフェース」へと変えます。
人間が判断を下す時、それはしばしば直線的な読書ではなく、比較、移動、フィルタリング、調整、効果の反復確認といった行為です。HTMLはこのような動作を受け止めてくれるのです。
最後に：Markdownは軽量テキストに、HTMLは複雑な計画に適している
もちろん、Thariq氏はHTMLを完璧な解決策とは言っていません。
HTMLは通常、Markdownよりも多くのトークンを消費し、生成も遅いです。彼が言及するには、HTMLの生成はMarkdownより2倍から4倍遅くなることがあります。バージョン管理も問題で、Markdownのdiffは明確ですが、HTMLのdiffはよりノイズが多い傾向があります。
ですから、この記事はMarkdownが時代遅れだとか、すべてのAI出力がHTMLになるべきだと言っているのではありません。
より正確に言えば、Markdownは軽量なテキスト、README、簡単な説明、長期メンテナンスのドキュメントに適しています。一方、HTMLは複雑な計画、コードの説明、視覚的なレポート、案の比較、インタラクティブなデバッグ、そして一回限りの意思決定インターフェースに適しています。
これはフォーマットの覇権争いではなく、シーンによる選択です。
そして記事の最後で、Thariq氏は非常に重要な感覚について語っています。彼がHTMLを好むのは、単に表現力が高いからだけではなく、それによって自分が「ループの中に留まり続けられる（stay in the loop）」からだと言います。
もっと平易な日本語に訳せば、それは「人間がAIの作業プロセスから置き去りにされない」ということです。
Claude Codeが数百行のMarkdown計画書を生成した時、あなたはそれをざっと見て、大体大丈夫そうだと思い、続行させます。表面的にはAIがより自動化されたように見えますが、実際には、人間は判断感覚を失いやすくなる可能性があります。
HTMLがもたらす変化は、人間を再びプロセスに引き戻すことです。計画を読みやすくし、案を比較しやすくし、コードの変更をレビューしやすくし、パラメータを調整しやすくし、結果をClaudeに返しやすくします。
つまり、HTMLの価値はClaudeをより自律的にすることではなく、人間がより介入しやすくすることにあります。
おそらくこれこそが、Thariq氏がHTMLを「理不尽なほどに効果的（unreasonably effective）」と評した理由なのでしょう。単にフォーマットを変えただけに見えますが、実際に変わるのは、人とClaude Codeの協業の感覚そのものなのです。
原文アドレス：
https://x.com/trq212/status/2052809885763747935