Версия в Markdown для агентов не работает
Страница предлагает агентам версию в Markdown — в ответ на Accept: text/markdown или через <link rel="alternate" type="text/markdown">, — но эта версия возвращает ошибку, пустое тело или HTML-страницу. Агенты, которые её запрашивают, не получают ничего полезного.
Что это значит
Страница предлагает агентам Markdown (в ответ на Accept: text/markdown или через ссылку на копию), но в ответ приходит ошибка, пустое тело или HTML-страница.
Почему это важно для AI-поиска
Агент, который видит ссылку на Markdown или получает ответ text/markdown, доверяет ему и может не вернуться к HTML. Сломанная копия хуже, чем никакой: агент либо выдаёт ошибку, либо принимает страницу ошибки за ваш контент.
Обычно так бывает после переезда или пересборки: файлы .md не задеплоили, правило перезаписи указывает на старый путь или middleware помечает HTML как text/markdown.
Как исправить
- Откройте URL из доказательств и посмотрите на статус,
Content-Typeи тело ответа. - Если копии больше нет, задеплойте её снова или удалите тег
<link rel="alternate" type="text/markdown">и заголовокLink, которые на неё указывают. - Если в ответе HTML или пустота, исправьте конвертацию, чтобы она возвращала текст страницы в Markdown с
Content-Type: text/markdown. - Нажмите «Проверить снова» в отчёте по странице, чтобы подтвердить результат.
Пример
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 Как проверить исправление
После изменения нажмите «Проверить ещё раз» в отчёте: он покажет, что исправлено и как изменилась оценка.