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