Няма Markdown версия за AI агенти

Кратък отговор

При заявка за страницата с Accept: text/markdown сървърът изпрати HTML, а страницата не сочи към Markdown копие. Тогава AI агентите четат целия HTML, включително менютата, долните колонтитули и скриптовете. Markdown версията не е задължителна: това е млада практика, затова находката е P3.

agent.no_markdown · Приоритет: P3

Какво означава

При заявка с Accept: text/markdown страницата отговори с HTML и не сочи към Markdown копие (<link rel="alternate" type="text/markdown">). Тогава агентите четат целия HTML, включително менютата и скриптовете. Незадължително: Markdown за агенти е млада практика, а не стандарт.

Защо това е важно за AI търсенето

Агентите, които разглеждат сайтове вместо потребителя (и инструментите, които зареждат страници в контекста на модел), работят с текст, а не с оформление. Чиста Markdown версия на страница е няколко пъти по-малка от HTML кода ѝ и запазва важните заглавия, списъци и връзки. Някои CDN и рамки вече отговарят на Accept: text/markdown с такава версия, а llmstxt.org предлага копие .md до всяка страница.

Без нея нищо не се чупи: ботовете продължават да четат HTML. Това е евтино подобрение, след като находките за достъп, robots.txt и съдържание са поправени.

Как да го поправите

  1. Изберете един начин за обслужване на Markdown: отговаряйте на Accept: text/markdown на собствения URL на страницата или публикувайте копие, например /guide/index.md.
  2. Ако ползвате CDN, включете неговото преобразуване в Markdown за агенти, ако има такова. В рамка добавете middleware, което връща Markdown версията, когато заглавката Accept иска text/markdown.
  3. Изпращайте Content-Type: text/markdown; charset=utf-8, а когато URL е същият като на HTML страницата, и Vary: Accept.
  4. Свържете копието от head на HTML с <link rel="alternate" type="text/markdown">, за да го намерят и агентите, които не договарят формата.
  5. Натиснете „Проверете отново“ в отчета за страницата, за да потвърдите резултата.

Пример

<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">

# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept

Как да потвърдите корекцията

След промяната натиснете „Проверете отново“ в отчета: той показва какво е поправено и как се е променила оценката.

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

Свързани ръководства

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