- [ Главная ](/ru/) / - Формат llms.txt # Формат `llms.txt`, справочник спецификации Полный справочник по формату файла llms.txt: обязательные и необязательные элементы, правила Markdown, синтаксис ссылок, вариант llms-full.txt и контрольный список для проверки файла. Последнее обновление: 12 августа 2026 г. На этой странице - [ Обзор формата ](#overview) - [ Обязательные элементы ](#required) - [ Необязательные разделы ](#sections) - [ Синтаксис ссылок ](#links) - [ Вариант llms-full.txt ](#llms-full) - [ Контрольный список ](#checklist) - [ Распространённые ошибки ](#mistakes) ## Обзор формата `llms.txt` представляет собой текстовый ресурс, использующий [Markdown CommonMark](https://commonmark.org/). Он может находиться в корне источника или по более специфичному пути, например `https://example.com/docs/llms.txt`. Наиболее конкретный применимый файл описывает эту область. Совместимые помощники по программированию, конвейеры RAG и исследовательские агенты могут использовать файл как тщательно отобранную карту. Одна публикация не доказывает обнаружение или использование, поэтому указывайте это с помощью `rel="describedby"` где это уместно, и измеряйте клиентов, которых вы действительно поддерживаете. ## Обязательные элементы Предложение 08.2026 определяет один обязательный элемент: - **Заголовок H1**, первая строка должна быть H1 (`# Name`) с названием проекта или сайта. Сводка в blockquote, пояснительное вступление, списки файлов H2 и примечания к ссылкам необязательны. Minimal valid llms.txt Копировать ``` # Your Project Name > One sentence describing what your project does and who it's for. ## Documentation - [Getting Started](https://example.com/docs/start): Install and first steps. - [API Reference](https://example.com/api): Full endpoint catalog. ## Optional - [Changelog](https://example.com/changelog): Release history. ``` ## Необязательные разделы Разделы — это заголовки H2 (`##`) с последующими неупорядоченными списками ссылок Markdown. Распространённые названия разделов: - **Документация**, основная документация, руководства, справочники. - **Продукт**, маркетинговые страницы, цены, статус. - **Примеры**, примеры кода, учебные материалы, демонстрации. - **Необязательно**, журнал изменений, блог, GitHub имеют более низкий приоритет для AI. - **API**, отдельный раздел справочника API. - **SDK**, библиотеки клиентов для конкретных языков. **Необязательно** остаётся понятной редакционной меткой для второстепенных ресурсов, но v2 не приписывает ей особой семантики обработки. Full example llms.txt Копировать ``` # Acme SaaS > Acme SaaS helps teams automate their billing workflows with a no-code dashboard > and a REST API supporting 40+ payment providers. ## Product - [Overview](https://acme.com/product): Core capabilities and use cases. - [Pricing](https://acme.com/pricing): Plans, limits, and enterprise options. - [Status](https://status.acme.com/): Uptime and incident history. ## Documentation - [Quickstart](https://acme.com/docs/quickstart): Set up in under 5 minutes. - [API Reference](https://acme.com/docs/api): REST endpoints, auth, rate limits. - [SDKs](https://acme.com/docs/sdks): Node, Python, Ruby, Go clients. - [Webhooks](https://acme.com/docs/webhooks): Event payloads and retry policy. ## Examples - [Node.js integration](https://acme.com/examples/node): End-to-end payment flow. - [Python integration](https://acme.com/examples/python): Subscription management. ## Optional - [Changelog](https://acme.com/changelog): Version history. - [Blog](https://acme.com/blog): Product updates and tutorials. - [GitHub](https://github.com/acme/acme-oss): Open-source components. ``` ## Синтаксис ссылок Каждая ссылка соответствует синтаксису Markdown `- [Title](URL): short description.` - Используйте **абсолютные URL** включая схему (`https://`). - Описание после двоеточия представляет собой обычный текст. Ограничьте его примерно 120 символами и сделайте информативным для ИИ, не наполняйте ключевыми словами. - Одна ссылка на элемент списка, не вкладывайте маркированные списки. - Предпочитайте канонические URL-адреса (с завершающей косой чертой, если так принято у вас). Пример Пишите описания для читателей-ИИ В отличие от HTML-альтернативного текста или SEO-метаописаний, описания ссылок в llms.txt читаются языковыми моделями, которые строят мысленную карту вашего проекта. Будьте точны: «Полный каталог REST-эндпоинтов с данными об аутентификации и ограничениях скорости» полезнее, чем «Документация API». ## вариант llms-full.txt В более широкой экосистеме используется необязательный сопутствующий файл `/llms-full.txt`. Хотя `llms.txt` — это индекс ссылок, `llms-full.txt` содержит *полный текст* всех этих связанных страниц, объединённых и оформленных в Markdown. Инструмент с явной поддержкой соглашения может запрашивать `llms-full.txt` для объединённого контекста. Компромисс — больший размер, устаревание и риск для безопасности. Ознакомьтесь с отдельным [Руководство по llms-full.txt](/ru/llms-full-txt/) для стратегий генерации. ## Контрольный список - Файл, размещённый в корне или по предполагаемому заданному пути - Тип медиа plain-text или Markdown с кодировкой UTF-8 - Начинается ровно с одного заголовка H1 - Необязательные blockquote и вступление не содержат заголовков - Цели ссылок корректно разрешаются в контексте публикации - Необязательные примечания к ссылкам должны быть краткими и фактологичными - Размер файла оправдан задачами и протестированными клиентами - Никаких HTML-тегов, никаких вложенных списков - Проверено с помощью [Валидатор llms.txt](/ru/validator/) ## Распространённые ошибки - **Относительные URL**, `- [Docs](/docs)` не будет корректно разрешаться, когда файл запрашивает сканер ИИ. Всегда используйте абсолютные URL. - **Отсутствует цитата**, это не ошибка соответствия v2. Добавляйте его только когда краткое фактическое резюме помогает целевому клиенту. - **Неправильный Content-Type**, обслуживая через `text/html` или отсутствие content-type приводит к тому, что некоторые парсеры отклоняют файл. - **Описания с переспамом ключевыми словами**, ИИ-модели читают их буквально. Перенасыщение ключевыми словами ухудшает сигнал качества. - **Перечисление каждой страницы**, отберите 10–30 самых важных ссылок. Используйте `sitemap.xml` для исчерпывающего обнаружения URL. Сопутствующий `llms-full.txt` может объединять содержимое для явно совместимых процессов загрузки, но не заменяет карту сайта. ## Связанные руководства - [Как создать llms.txt](/ru/how-to-create/), пошагово для любого стека. - [Руководство по llms-full.txt](/ru/llms-full-txt/), файл-спутник с полным содержимым. - [Валидатор](/ru/validator/), проверьте соответствие файла спецификации. - [Генератор](/ru/generator/), создайте файл из формы. - [Лучшие практики](/ru/best-practices/), что включать, а что пропускать. - [Какие AI-краулеры читают llms.txt](/ru/llms-txt-ai-crawlers/), статус внедрения. ## Источники - [ llmstxt.org, предложение сообщества ](https://llmstxt.org/) - [ Answer.AI, исходное предложение ](https://www.answer.ai/posts/2024-09-03-llmstxt.html)