llms.txt версии 2: что изменилось в спецификации и как обновить свой файл

Формат llms.txt появился в сентябре 2024 года как предложение: положить в корень сайта markdown-файл с кратким описанием и ссылками на главные материалы, чтобы языковым моделям и агентам было проще понять сайт. Тогда это была скорее гипотеза. В августе 2026 года автор формата выпустил версию 2, обновлённую по итогам двух лет практики.

Если у вас уже есть файл llms.txt, он, скорее всего, остаётся корректным. Но новая версия уточняет несколько важных вещей: как агенту найти markdown-версию страницы, что означает файл в подпапке и как на самом деле используют файл. Разберём всё по официальному описанию и покажем, что стоит поменять на сайте.

Что осталось прежним

Базовая структура не изменилась. Файл по спецификации содержит:

1. Необязательный маркер порядка байтов (BOM).
2. Заголовок первого уровня H1 с названием проекта или сайта. Это единственная обязательная часть.
3. Цитату (blockquote) с краткой сводкой проекта.
4. Ноль или больше разделов с произвольной разметкой, кроме заголовков, с пояснениями.
5. Ноль или больше разделов под заголовками H2 со списками ссылок. Каждая запись: обязательная markdown-ссылка [название](адрес), затем необязательно двоеточие и пояснение.

Пример:

# Название сайта

> Кратко: чем занимается сайт и для кого он.

Дополнительные пояснения о том, как читать ссылки ниже.

## Документация

- [Быстрый старт](https://example.ru/docs/start.md): с чего начать
- [Цены](https://example.ru/pricing.md): тарифы и ограничения

## Optional

- [История изменений](https://example.ru/changelog.md)

Что изменилось в версии 2

Страница изменений на сайте спецификации выделяет следующее.

1. Как найти markdown-версию и сам файл

Самой частой просьбой при внедрении была обнаруживаемость: как агенту, зная страницу, найти её markdown-версию или llms.txt, который её описывает, не угадывая адреса. Версия 2 отвечает стандартными типами связей:

• rel="alternate" type="text/markdown" указывает на markdown-версию страницы;
• rel="describedby" указывает на llms.txt, который покрывает страницу.

Передать их можно элементами <link> в HTML или HTTP-заголовком Link::

Link: </docs/page.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"

2. Две формы адреса markdown-страницы

В версии 1 для markdown-версии предлагалось дописывать .md к полному адресу страницы (page.html.md). Некоторые инструменты вместо этого заменяют расширение (page.md). Версия 2 допускает оба варианта. Для адресов без имени файла к пути дописывается index.html.md.

3. Файлы в подпапках получили определение

Раньше было сказано, что llms.txt можно класть в подпапки, но не объяснялось, что это значит. Теперь определено: файл покрывает страницы в своём пути, а если подходящих файлов несколько, применяется самый специфичный. Это важно для сайтов, где владелец управляет только частью адресов, например проект на GitHub Pages, и для компаний, у которых документация живёт в /docs/, а маркетинговый сайт отдельно.

4. Описано, как файл используют

В версии 1 упоминался инструмент llms_txt2ctx, который разворачивал файл в контекст для модели. Версия 2 вместо этого прямо говорит, чего ждать от агентов: они просматривают или ищут по llms.txt, находят нужное и переходят по ссылкам, которые должны вести на удобный для моделей контент. Инструменты разворачивания контекста больше не входят в предложение.

5. Раздел Optional стал соглашением

Раньше раздел Optional имел механический смысл: инструменты могли пропускать его, когда нужен короткий контекст. Теперь это только договорённость для второстепенных ссылок. Вы можете оставить раздел, но не стоит рассчитывать, что он автоматически отсекается.

Пример: компания с сайтом и документацией

Допустим, у сервиса есть маркетинговый сайт на example.ru и документация в example.ru/docs/. По версии 2 разумно сделать два файла.

Файл /llms.txt описывает компанию в целом:

# Пример: сервис онлайн-записи

> Пример помогает салонам и клиникам принимать онлайн-записи. Ниже основные страницы: тарифы, условия, документация.

## Компания

- [Тарифы](https://example.ru/pricing/): стоимость и ограничения по числу сотрудников
- [Условия использования](https://example.ru/terms/): права и обязанности сторон
- [Контакты](https://example.ru/contacts/): поддержка и реквизиты

## Документация

- [Индекс документации](https://example.ru/docs/llms.txt): все руководства и справочник API

Файл /docs/llms.txt покрывает только документацию и перечисляет руководства и справочник API со ссылками на markdown-версии страниц. Если агент разбирает страницу из /docs/, он использует самый специфичный файл, то есть второй. Если он читает страницу «Тарифы», подойдёт корневой.

Ошибки, которые встречаются чаще всего

• Файл отдаёт HTML. Сервер возвращает страницу 404 или заглушку со статусом 200. Агент получает не markdown, а вёрстку.
• Ссылки ведут на редиректы или закрытые страницы. Проверяйте все адреса скриптом.
• В описании маркетинговые лозунги. Агенту нужны факты: что делает продукт, какие ограничения, где цены.
• Файл не обновляется. Если в нём страницы, которых больше нет, доверие к указателю падает. Генерируйте файл при каждой публикации.
• В файл попали внутренние адреса. Он публичный.

Что говорит об использовании сам автор

В описании версии 2 сказано, что тысячи сайтов уже публикуют llms.txt, платформы документации создают его автоматически, а Lighthouse в Chrome проверяет его наличие в рамках проверок для агентного просмотра. На странице формата также названы примеры от самих ИИ-лабораторий: файлы для документации разработчиков публикуют OpenAI, Anthropic и Gemini.

Что важно понимать: формат остаётся добровольным соглашением. Из этого не следует, что любой ассистент или поисковая система его читает. Google, например, пишет в рекомендациях по ИИ-функциям поиска, что для показа в обзорах ИИ и режиме ИИ не нужны новые машиночитаемые файлы и тексты для ИИ. Поэтому llms.txt лучше рассматривать как удобный указатель для агентов, которые его читают, и как повод привести в порядок структуру сайта, а не как рычаг ранжирования.

Как проверить Lighthouse

В описании проверки Lighthouse сказано: страница помечается, если при запросе файла возникает ошибка сервера. Если файла нет и сервер отвечает 404, проверка считается неприменимой, потому что файл пока необязателен. Чтобы убрать замечание, создайте llms.txt в корне сайта (https://ваш-сайт/llms.txt) в соответствии со спецификацией и кратко опишите назначение сайта и ключевые ссылки. Проверяйте, что файл отдаётся со статусом 200, а не с 5xx.

Что обновить на сайте: чек-лист

1. Убедитесь, что файл отдаётся со статусом 200 и текстовым или markdown-типом содержимого, а не HTML-страницей ошибки.
2. Проверьте структуру: H1 с названием, цитата с краткой сводкой, разделы H2 со списками ссылок.
3. Проверьте все ссылки. Битая ссылка в индексе подрывает смысл файла.
4. Опубликуйте markdown-версии главных страниц, если можете. Чистый текст без навигации и скриптов удобнее для агентов, чем HTML.
5. Добавьте связи: rel="alternate" type="text/markdown" на страницах и rel="describedby" на llms.txt.
6. Если у вас несколько частей сайта, рассмотрите отдельные файлы в подпапках: например, /docs/llms.txt для документации и /llms.txt для общего описания.
7. Не рассчитывайте на раздел Optional: ключевые материалы держите в основных разделах.
8. Не публикуйте в файле закрытые адреса и внутренние заметки.
9. Проверьте файл глазами агента: задайте ассистенту вопрос по вашему сайту, дав только llms.txt как отправную точку. Это рекомендация самой спецификации.

Рекомендации по тексту из спецификации

Автор формата советует:

• писать кратко и ясно;
• к каждой ссылке давать короткое информативное описание;
• избегать двусмысленных терминов и необъяснённого жаргона;
• проверять файл, задавая агенту вопросы по содержимому.

Эти правила применимы и к российским сайтам. Описание «Тарифы и ограничения для юрлиц» полезнее, чем «Подробнее».

Где взять файл или создать его автоматически

На странице формата перечислены платформы и плагины, которые создают llms.txt: Mintlify и GitBook для документации, плагины Yoast SEO и AIOSEO для WordPress, генерация в Wix, а также библиотеки для VitePress, Docusaurus и Drupal. Для обычного сайта проще всего начать с генератора llms.txt и проверить результат в аудите. Подробную пошаговую инструкцию вы найдёте в статье Как создать llms.txt, а общее объяснение формата в статье Что такое llms.txt.

Вопросы и ответы

Нужно ли переписывать llms.txt, если он создан по версии 1?

Как правило, нет. Структура файла не изменилась. Имеет смысл добавить связи alternate и describedby, проверить ссылки и подумать о markdown-версиях страниц.

Обязателен ли раздел Optional?

Нет, он всегда был необязательным. В версии 2 он остаётся допустимым, но не имеет механического смысла: это только соглашение о второстепенных ссылках.

Можно ли положить llms.txt в подпапку?

Да. Файл покрывает страницы под своим путём, а если подходящих файлов несколько, применяется самый специфичный.

Читают ли llms.txt Яндекс и Google?

Для Google в рекомендациях сказано, что для ИИ-функций поиска не нужны специальные файлы. Подтверждённого заявления о том, что llms.txt влияет на ранжирование, мы не нашли. Файл читают агенты и инструменты, которые на него рассчитаны, прежде всего для документации.

Чем llms.txt отличается от sitemap.xml и robots.txt?

Sitemap перечисляет все страницы для поисковых систем, а llms.txt даёт короткий отобранный обзор для моделей. Robots.txt управляет доступом краулеров. Файлы дополняют друг друга. Сравнение есть на странице стандартов.

Что проверяет Lighthouse?

Проверка срабатывает, если при запросе файла возникает ошибка сервера. Ответ 404 считается неприменимым, потому что файл пока необязателен.

Нужны ли markdown-версии, если у меня маленький сайт?

Не обязательно. Для небольшого сайта достаточно корректного llms.txt со ссылками на обычные страницы. Markdown-версии дают заметную пользу там, где агенты часто читают много страниц подряд: в документации и справочниках. Начните с главных 5–10 страниц и расширяйте набор, если увидите, что агенты ими пользуются.

Итоги

Версия 2 не ломает существующие файлы, но уточняет три вещи: как агенту найти markdown-версию страницы и сам файл, что значит файл в подпапке и как его на самом деле используют. Проверьте статус и ссылки, добавьте связи и markdown-версии главных страниц, а затем протестируйте файл на реальном ассистенте.