Версия в Markdown для агентов не работает

Короткий ответ

Страница предлагает агентам версию в Markdown — в ответ на Accept: text/markdown или через <link rel="alternate" type="text/markdown">, — но эта версия возвращает ошибку, пустое тело или HTML-страницу. Агенты, которые её запрашивают, не получают ничего полезного.

agent.markdown_broken · Приоритет: P2

Что это значит

Страница предлагает агентам Markdown (в ответ на Accept: text/markdown или через ссылку на копию), но в ответ приходит ошибка, пустое тело или HTML-страница.

Почему это важно для AI-поиска

Агент, который видит ссылку на Markdown или получает ответ text/markdown, доверяет ему и может не вернуться к HTML. Сломанная копия хуже, чем никакой: агент либо выдаёт ошибку, либо принимает страницу ошибки за ваш контент.

Обычно так бывает после переезда или пересборки: файлы .md не задеплоили, правило перезаписи указывает на старый путь или middleware помечает 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

Как проверить исправление

После изменения нажмите «Проверить ещё раз» в отчёте: он покажет, что исправлено и как изменилась оценка.

Проверить мою страницу →

Связанные руководства

Все находки и как считается оценка