# llms.txt v2: что изменилось во второй редакции

> Чем вторая редакция llms.txt отличается от первой: обнаружение через rel=alternate и rel=describedby, файлы в подпутях, две формы Markdown-адресов, новая роль Optional

Страница: https://llms-full-txt.ru/specification/changes/
Указатель сайта: https://llms-full-txt.ru/llms.txt

## Коротко

Вторая редакция proposal `llms.txt` опубликована 10 августа 2026 года. Формат самого файла почти не изменился. Изменилось то, что вокруг него: как агент находит файл, что значит файл в подпути и как им пользуются.

Первая редакция вышла 3 сентября 2024 года. Автор обеих - Jeremy Howard (Answer.AI). Это по-прежнему proposal одного автора, а не стандарт IETF или W3C.

Короткий пересказ события: [Вышла вторая редакция llms.txt](https://llms-full-txt.ru/blog/llms-txt-v2/).

## Таблица отличий

| Тема | Первая редакция (2024) | Вторая редакция (2026) |
|---|---|---|
| Обнаружение | только соглашение об адресе `/llms.txt` | две связи: `rel="alternate" type="text/markdown"` и `rel="describedby"`, в HTML или в заголовке `Link` |
| Файл в подпути | допускался, смысл не определён | покрывает адреса под своим путём; из нескольких подходящих берётся самый специфичный |
| Markdown-версия страницы | только `page.html.md` | две формы: `page.html.md` и `page.md` |
| Секция `Optional` | особый механический смысл | соглашение для второстепенных ссылок |
| `llms_txt2ctx`, `llms-ctx.txt` | часть proposal | убраны |
| Как файл используется | не описано | агент читает файл или ищет по нему, затем идёт по ссылкам |
| `/.well-known/` | не обсуждался | отклонён с объяснением |
| `llms-full.txt`, `llms-small.txt` | нет | нет |

## Обнаружение

Самый частый запрос сообщества: как агенту, получившему страницу, найти её Markdown-версию или файл `llms.txt`, который её покрывает, не угадывая адрес.

Ответ [второй редакции](https://llmstxt.org/) - стандартные связи:

```html
<link rel="alternate" type="text/markdown" href="/docs/page.html.md">
<link rel="describedby" href="/docs/llms.txt">
```

То же самое можно отдать заголовком ответа. Такой способ работает для любых файлов, не только HTML, и настраивается на сервере без правки страниц:

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

Подробно о связях и заголовках: [Обнаружение файла и Markdown-версий](https://llms-full-txt.ru/specification/discovery/).

## Файлы в подпутях

Первая редакция разрешала класть `llms.txt` не в корень, но не говорила, что это значит. Вторая определяет:

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

```text
/llms.txt        -> весь сайт
/docs/llms.txt   -> всё в /docs/
```

Это позволяет участвовать тем, кто управляет только частью домена.

## Две формы Markdown-адресов

Первая редакция задавала одну форму: `.md` добавляется к полному адресу страницы. Часть инструментов публикации вместо этого заменяет расширение. Вторая редакция разрешает оба варианта:

```text
page.html  ->  page.html.md
page.html  ->  page.md
/docs/     ->  /docs/index.html.md  или  /docs/index.md
```

## Модель использования

Первая редакция описывала инструмент `llms_txt2ctx`, который разворачивал файл в готовый контекст для модели. Вторая говорит прямо: агент просматривает `llms.txt` или ищет по нему, а затем идёт по нужным ссылкам. Ссылки поэтому должны вести на содержание, удобное модели.

Вместе с инструментом из proposal ушли:

- файлы `llms-ctx.txt` и `llms-ctx-full.txt`;
- особый смысл секции `Optional`, которая подсказывала инструменту, что можно отбросить.

Секция `Optional` осталась как соглашение для второстепенных ссылок.

## Почему не /.well-known/

Вторая редакция объясняет отказ от адреса в `/.well-known/` (RFC 8615). Такие адреса существуют только в корне домена. Многие авторы управляют лишь путём на общем хосте и добавить файл в корень не могут. `llms.txt`, как и `index.html`, описывает путь, в котором лежит.

## Что не изменилось

- Обязателен только заголовок H1.
- Порядок частей: H1, цитата, подробности без заголовков, секции H2 со списками ссылок.
- Формат элемента списка: ссылка и необязательное пояснение после двоеточия.
- Файл ничего не запрещает и не управляет доступом.

## Чего нет в обеих редакциях

- `llms-full.txt` и `llms-small.txt`. Эти файлы появились как практика платформ документации и в текст proposal не входят.
- Требований к `Content-Type`.
- Раздела о безопасности и недоверенном содержимом.
- Правила о языке корневого файла на многоязычном сайте.

Последние три вопроса открыты в репозитории proposal.

## Что сделать владельцу сайта

1. Если на сайте уже есть `llms.txt`, переделывать его не нужно: формат остался прежним.
2. Проверить ссылки в файле: по возможности они должны вести на Markdown-версии страниц.
3. Если Markdown-версии есть, добавить на страницы `rel="alternate" type="text/markdown"`.
4. Добавить `rel="describedby"` со ссылкой на покрывающий `llms.txt`.
5. Не рассчитывать на особую обработку секции `Optional`.

:::note[Что известно о внедрении]
Вторая редакция новая. При проверке 46 сайтов 3 октября 2026 года связь `rel="describedby"` нашлась только у одного. Часть платформ документации отдаёт собственные нестандартные заголовки вместо неё.
:::