Markdown文書はなぜ読まれないのか
Claude Codeで作業していると、企画書、コード分析、リサーチ要約がすべてMarkdownで積み上がります。内容は十分でも、100行を超えると記号とインデントだらけの画面になり、冒頭だけ眺めて読み飛ばすようになります。
AnthropicのClaude Codeエンジニアが今年5月、ブログで同じ告白をしました。「HTMLは新しいMarkdownだ」。本人も100行を超えるMarkdownは読まなくなり、成果物をHTMLで受け取り始めたといいます。問題は文書の不足ではなく、生成速度が読解速度を追い越したことです。
HTML変換の一行で何が変わるのか
プロンプトは一行で足ります。「リサーチMarkdownをHTMLに変換して。上部にチャンネル別のタブを作り、内容はテーマ別のカードレイアウトに」。同じ内容がタブとカードに再配置されるだけで、スクロールせずに全体が一望でき、Markdownで読むときとは理解速度が目に見えて変わります。
レイアウト、チャート、表は指定したとおりに出てきます。「HTMLにして」の一言から始めて、欲しい構造を少しずつ具体化すればよいのです。
Playgroundプラグインは何を加えてくれるのか
静的HTMLでは届かない最後の一歩がインタラクションです。ボタンを押し、スライダーを動かして確かめる動的な画面は、単純な変換依頼ではうまく出てきません。Anthropicはこれを Playgroundプラグインとして提供しています。Claude Codeで /plugin install playground@claude-plugins-official の一行でインストールでき、問題タイプ別のテンプレートが内蔵されています。
コードベースの依存関係を可視化すると、モジュールが色分けされたノードマップとして描かれ、レイヤー別のプリセットボタンで見たい部分だけに集中できます。ノードに付けたコメントはフィードバックプロンプトに変換され、Claude Codeに貼り付ければそのモジュールを対象にした分析が始まります。
実行フローも同様です。質問ひとつが回答になるまでの8段階のプロセスを動的に示し、質問プリセットを押せば該当する流れが強調されます。テキストの説明を読むより時間は短く、理解は深くなります。
いつHTMLで、いつテキストか
すべてをHTMLで受け取るとトークンがはるかに多くかかります。基準はシンプルです。表、ダイアグラム、カードで見たほうが理解の速い完成物はHTML、下書きやメモ、エージェント間のデータのような中間生成物はテキストにしてトークンを節約します。
それでもトークンを多く使う価値がある理由は明確です。AIが文書を作る速度は、すでに人が理解する速度を追い越しています。その差を縮めることが、いまの時点での生産性です。AIに任せる能力ではなく、AIの成果物を素早く読み、検証する能力なのです。