エージェント向けの Markdown 版が壊れています

短い答え

このページは Accept: text/markdown への応答または <link rel="alternate" type="text/markdown"> を通じてエージェントに Markdown 版を提供していますが、その版はエラー、空の本文、または HTML ページを返します。それを求めたエージェントは役に立つものを何も受け取れません。

agent.markdown_broken · 優先度: P2

意味

このページはエージェントに Markdown を提供していますが (Accept: text/markdown への応答、またはリンクされたコピー)、返ってくるのはエラー、空の本文、または HTML ページです。

AI 検索で重要な理由

Markdown のリンクを見つけたり text/markdown の応答を受け取ったりしたエージェントは、それを信頼し、HTML に戻らないことがあります。壊れたコピーはないよりも悪い結果を招きます。エージェントは失敗するか、エラーページをあなたのコンテンツとして読んでしまいます。

これは通常、移転や再構築のあとに起こります。.md ファイルがデプロイされていない、リライトルールが古いパスを指している、ミドルウェアが HTML に text/markdown のラベルを付けている、といったケースです。

修正方法

  1. 証拠にある URL を開き、ステータス、Content-Type、本文を確認します。
  2. コピーがなくなっている場合は、もう一度デプロイするか、それを指している <link rel="alternate" type="text/markdown"> タグと Link ヘッダーを削除します。
  3. 応答が HTML または空の場合は、ページのテキストを Markdown として Content-Type: text/markdown で返すよう変換を修正します。
  4. ページのレポートで「もう一度チェック」を実行して結果を確認してください。

例

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept

修正の確認方法

変更後、レポートで「もう一度チェック」を押してください。修正されたものとスコアの変化が表示されます。

ページをチェック →

関連ガイド

すべての指摘とスコアの仕組み