AIへの出力フォーマット、まだMarkdown指定していますか？

「Markdown形式で出力してください」——AIとのやり取りでこのフレーズを使っている人は多いはずだ。実はこの習慣、そろそろ見直しどきかもしれない。あるAIエージェント開発チームのメンバーが提言した「HTMLで出力を求めたほうが、圧倒的に情報が豊かになる」という主張が注目を集めている。単なる好みの話ではなく、時代背景を踏まえた技術的な根拠がある。

Markdownが定着した歴史的背景

Markdownがプロンプトでのデファクト出力形式になったのには、れっきとした理由がある。GPT-4が登場した当時、コンテキストウィンドウは8,192トークンという厳しい制限があった。HTMLと比較してMarkdownはトークン効率が格段に高く、限られた枠でより多くの情報を詰め込める。その実用的な判断が、そのまま業界の習慣として定着した。

言わば「当時の制約に最適化されたベストプラクティス」が、制約が消えた後も惰性で使われ続けている状態だ。

制約が消えた今、何が変わるのか

2026年現在、主要モデルのコンテキストウィンドウは飛躍的に拡大している。トークン効率を最優先に考える必要性は大幅に下がった。そこで問い直されるのが「出力形式を何のために指定するのか」だ。

Markdownの価値は「シンプルで汎用性が高い」こと。一方、HTMLの強みは表現力の豊かさにある。HTMLで出力を求めれば、以下が使えるようになる：

  • SVGダイアグラム — アーキテクチャ図やフローチャートをテキスト内に直接埋め込める
  • インタラクティブなウィジェット — JavaScriptによるクリック・展開・絞り込みが可能
  • ページ内ナビゲーション — 長い技術ドキュメントでもアンカーリンクで素早く移動できる
  • 視覚的な重み付け — CSSでコンテンツの重要度を色・サイズ・配置で直感的に伝えられる

Markdownはテキストエディタで読む前提の形式だ。AIの出力をブラウザや専用ビューアで消費するなら、HTMLの表現力を活かさない理由はない。

実践的なプロンプト例

PRレビュー支援のプロンプトとして、こんな指示が提案されている：

出典: この記事は Using Claude Code: The Unreasonable Effectiveness of HTML の内容をもとに、筆者の見解を加えて独自に執筆したものです。