Accept text/markdown で AI に配信
目次
この記事でわかること
- HTTP コンテンツネゴシエーションと
Acceptヘッダの基本的な仕組み - なぜ AI は HTML より Markdown を効率的に読めるのか
- 同一 URL での出し分けと、Link ヘッダで Markdown 版へ誘導する 2 つの実装の考え方
コンテンツネゴシエーションとは
HTTP には、クライアントが希望するデータ形式をサーバに伝え、サーバが対応する表現を返すコンテンツネゴシエーションという仕組みがあります。クライアントはリクエスト時に Accept ヘッダで希望するメディアタイプ（例: text/html）を伝え、サーバはそれに合わせた表現を返します。言語や圧縮方式の出し分けにも使われる、HTTP に古くからある確立した仕組みです。
これを AI 向けに応用すると、Accept: text/markdown というリクエストに対して Markdown 版のコンテンツを返す、という配信ができます。同じページでも、相手が人間のブラウザなら HTML、AI なら Markdown、と表現を切り替えられるわけです。
なぜ AI は Markdown が得意なのか
AI（LLM）は HTML よりも、無駄のない Markdown のほうを効率的に読めます。HTML は div や span、class、style といったマークアップを大量に含み、本文以外の構造情報が多くを占めます。一方 Markdown は見出しと本文が中心で、装飾のためのタグがほとんどありません。
この違いは、AI が処理するデータ量（トークン）に直結します。同じ中身でも、HTML を読ませると装飾部分まで処理する必要があり、Markdown を返せばその分を削れます。AI が読み取る効率が上がり、消費するトークンを大きく減らせるのが利点です。
実装の考え方は 2 通り
Markdown 版を AI に届ける方法には、大きく分けて 2 つの選択肢があります。
1. 同一 URL で Accept に応じて出し分ける
1 つ目は、コンテンツネゴシエーションそのものです。同じ URL に対して、Accept: text/markdown が来たら Markdown を、それ以外なら HTML を返します。URL を分けずに済むため、人間にも AI にも同じアドレスを案内できるのが利点です。
2. Link ヘッダで Markdown 版へ誘導する
2 つ目は、HTML を返しつつ、HTTP レスポンスの Link ヘッダで Markdown 版の場所を案内する方法です。HTML を取得した AI が「この内容には Markdown 版がある」と気づける形にしておきます。Markdown 版を別 URL に置く構成と相性がよく、既存サイトに後から足しやすいのが特長です。実際、当サイトも /agent-markdown/<path> という別パスで Markdown 版を配信しています。
どちらの方法でも、サイトの読みどころを 1 ファイルにまとめる llms.txt とは と組み合わせると、AI がサイト全体を把握しやすくなり相補的に働きます。
よくある質問
コンテンツネゴシエーションと Link ヘッダ、どちらがよいですか
既存サイトに後付けするなら、別 URL に Markdown 版を置いて Link ヘッダで案内する方法が始めやすいです。1 つの URL で完結させたい場合は、Accept に応じた出し分けが向きます。サイトの構成に合わせて選べば十分です。
Markdown 版を用意すると SEO に不利になりませんか
人間向けの HTML はこれまでどおり同じ URL で返るため、検索エンジンの評価には影響しません。Markdown 版は、Markdown を希望するクライアント向けの追加の表現という位置づけです。
すべてのページで対応が必要ですか
まずは主要なコンテンツページから始めれば十分です。記事やサービス説明など、AI に正しく読まれたいページを優先するのが現実的です。
まとめ
- コンテンツネゴシエーションは、
Acceptヘッダで希望形式を伝え、サーバが対応する表現を返す HTTP の仕組み - AI は HTML より Markdown を効率的に読め、処理データ量（トークン）を減らせる
- 実装は「同一 URL で Accept 出し分け」か「Link ヘッダで Markdown 版へ誘導」の 2 通り
llms.txtと組み合わせると、AI がサイト全体を把握しやすくなる
この仕組みは AI エージェント対応とは の一部であり、土台となる DNS・robots・SSL が正しく整っていることが前提になります。
まずは自社サイトの基盤を確認しませんか
Markdown 配信や AI 向けの対応を進める前に、自社ドメインの土台が整っているか確認しておくと安心です。SPF / DKIM / DMARC / SSL / DNS の状態は、ドメイン番人の無料診断で数十秒で確認できます。robots.txt や llms.txt などの対応状況は、URL を入れるだけで採点できるAI エージェント対応チェックもあわせてご利用ください。単発のチェックツールは無料ツール一覧にまとめています。