# Markdown-версии страниц для нейросетей: зачем и как отдавать > Зачем сайту Markdown-версии страниц для AI-агентов и три способа их отдавать: отдельный адрес .md, заголовок Accept и ссылка rel=alternate Страница: https://llms-full-txt.ru/guides/markdown-pages/ Указатель сайта: https://llms-full-txt.ru/llms.txt Markdown-версия - это та же страница, но без меню, подвала, рекламы и оформления: только заголовки, текст, списки, таблицы и ссылки. Агенту с ней проще. В HTML-странице полезного текста часто меньше, чем разметки вокруг него, а объём, который модель может прочитать за раз, ограничен. Это дополнение к HTML, а не замена. Люди и поисковые системы по-прежнему получают обычную страницу. ## HTML и Markdown одной страницы - Что получает клиент - HTML - для браузера и поиска - Меню, шапка, подвал, скрипты, стили - Структурированные данные в коде страницы - Много служебной разметки вокруг текста - Markdown - для агента - Только содержание - Заголовки и списки сохраняют структуру - Нет JSON-LD и интерактивных частей ## Три способа отдать Markdown **Отдельный адрес** К адресу страницы добавляется `.md`. Способ описан во [второй редакции proposal](https://llmstxt.org/) `llms.txt`. ```text https://example.ru/docs/install.html страница https://example.ru/docs/install.html.md её Markdown-версия https://example.ru/docs/ страница без имени файла https://example.ru/docs/index.html.md её Markdown-версия ``` Допустимы обе формы: `page.html.md` и `page.md`. Плюс способа: адрес можно открыть в браузере и положить в `llms.txt`. **Заголовок Accept** Адрес один, а формат выбирает клиент. Агент просит Markdown заголовком запроса: ```http GET /docs/install/ HTTP/1.1 Host: example.ru Accept: text/markdown ``` Сервер отвечает тем же содержанием с типом `text/markdown`. Обычный браузер такого заголовка не шлёт и получает HTML. Так устроены документация OpenAI, Stripe и Cursor. [Cloudflare](https://blog.cloudflare.com/markdown-for-agents/) с февраля 2026 года умеет делать такое преобразование на своей стороне, без правок сайта. Функция входит в платные тарифы, а тариф Cloudflare можно [оплатить из России](https://llms-full-txt.ru/go/pay-cloudflare/). **Ссылка rel=alternate** Страница сама сообщает, где её Markdown-версия. Это связь из второй редакции proposal: ```html ``` То же можно передать заголовком ответа: ```http Link: ; rel="alternate"; type="text/markdown" ``` Агенту не нужно угадывать адрес: он читает его со страницы. Способы не исключают друг друга. Подробно о связях обнаружения: [Обнаружение файла и Markdown-версий](https://llms-full-txt.ru/specification/discovery/). ## Что должно быть в Markdown-версии - **То же содержание, что в HTML.** Другой текст для машины - это подмена, и поисковые системы относятся к ней плохо. - **Один заголовок первого уровня** и осмысленные заголовки разделов. - **Абсолютные ссылки.** Агент читает файл вне сайта, относительный путь ему некуда приложить. - **Таблицы таблицами, код в блоках кода.** Снимок экрана с таблицей машина не прочитает. - **Без навигации, подвала и форм.** - **Тип ответа `text/markdown` или `text/plain`**, кодировка UTF-8. ## Связь с llms.txt В `llms.txt` лучше ссылаться на Markdown-версии, если они есть. Тогда агент проходит путь целиком: карта, затем чистый текст. Если Markdown-версий нет, файл со ссылками на обычные страницы всё равно корректен. Proposal рекомендует Markdown, но не требует. ## Что известно о пользе **Подтверждено** - Сайты документации OpenAI, Anthropic, Stripe, Cloudflare, GitHub отдают Markdown-версии страниц. - Платформы документации создают их автоматически для всех сайтов. - [Mintlify](https://www.mintlify.com/blog/the-state-of-knowledge-2026-highlights) сообщает, что на её сайтах агенты запрашивают документацию чаще людей. Источник заинтересован: это его продукт. **Не доказано** - Что Markdown-версия увеличивает число цитирований или переходов. - Что боты поисковых AI-систем сами запрашивают `.md`. В опыте [OtterlyAI](https://otterly.ai/blog/the-llms-txt-experiment) за 14 дней таких обращений не было ни одного. **Чего это не означает** - Это не способ попасть в поисковый индекс: поиск читает HTML. - Это не замена структурированным данным: в Markdown нет разметки сущностей. Вывод трезвый: Markdown-версии полезны там, где сайт читают агенты по ходу работы, прежде всего в документации. Для магазина или блога это задел, а не срочная задача. Подробнее в блоге: [Cloudflare отдаёт агентам Markdown](https://llms-full-txt.ru/blog/cloudflare-markdown-for-agents/), [опыт Mintlify с четырьмя форматами](https://llms-full-txt.ru/blog/mintlify-markdown-benchmark/). ## Как проверить 1. Запроси страницу с заголовком `Accept: text/markdown` или открой адрес с `.md`. 2. Ответ `200`, тип `text/markdown` или `text/plain`. 3. В ответе текст, а не HTML-страница. 4. Содержание совпадает с обычной страницей. 5. Ссылки абсолютные и рабочие. 6. Если есть `rel="alternate"`, адрес в нём отвечает `200`. ```bash curl -sI -H 'Accept: text/markdown' https://example.ru/docs/install/ curl -sI https://example.ru/docs/install.html.md ``` ## Кто так делает - [OpenAI](https://developers.openai.com/llms.txt): Корневой индекс и вложенные файлы для /api, /codex, /commerce. Не доказывает: что chatgpt читает чужие llms.txt. - [Anthropic](https://platform.claude.com/llms.txt): Индекс документации и полный текст одним файлом. Не доказывает: что claude читает чужие llms.txt. - [Cloudflare](https://developers.cloudflare.com/llms.txt): Очень большой индекс: полный текст занимает 67 МБ. Не доказывает: что файл такого размера удобен агенту целиком. - [Stripe](https://docs.stripe.com/llms.txt): llms-full.txt не обязателен: хватает индекса и Markdown-страниц. Не доказывает: что отказ от полного файла - общее правило. - [Cursor](https://cursor.com/llms.txt): Единственный замеренный сайт с rel=describedby из второй редакции. Не доказывает: что вторая редакция уже распространена. - [GitHub Docs](https://docs.github.com/llms.txt): Индекс без полного файла на большой документации. Не доказывает: что copilot опирается на этот файл. - [Mintlify](https://www.mintlify.com/docs/llms.txt): Платформа создаёт файлы автоматически для всех сайтов на ней. Не доказывает: качество каждого такого файла. - [Yandex Cloud](https://yandex.cloud/llms.txt): Пример на русском сайте. Не доказывает: что поиск яндекса использует такие файлы. Проверено 3 октября 2026.