3 июля 2026 года разбираю, почему Markdown удобен для общения с нейросетями. Джон Грубер описывает его как читаемый текстовый формат и инструмент преобразования в HTML. Это полезная отправная точка: формат помогает организовать документ, а не наделяет модель особыми способностями.
У Markdown нет сложной оболочки. Заголовки обозначаются решётками, пункты списка начинаются с дефиса, имена файлов можно заключить в обратные кавычки. Такой документ удобно открыть в редакторе, отправить коллеге или положить рядом с кодом проекта. Даже без оформления смысл остаётся виден.
Формат появился задолго до нынешних ИИ-агентов
Markdown разработали в 2004 году Джон Грубер и Аарон Шварц. Первый конвертер Грубер написал на Perl. Главным образцом были обычные текстовые письма: в них уже использовали угловую скобку для цитаты, звёздочки для акцента и простые списки. Новая разметка закрепила привычные приёмы, а не заставила автора изучать редактор с десятками панелей.
Название относится и к синтаксису, и к программе преобразования текста в HTML. Поэтому исходный файл сам по себе не является готовой веб-страницей. За внешний вид отвечают конвертер, шаблон и стили сайта. Получение PDF или другой разновидности документа требует отдельного инструмента.
Заголовки помогают разделить задачу и исходные данные
В запросе к модели полезно явно отделить просьбу, ограничения, пример и ожидаемый результат. Это можно сделать обычными фразами. Markdown добавляет узнаваемое оформление, особенно когда задача занимает несколько экранов. Важно не количество решёток, а то, что у каждого раздела есть понятное назначение.
# Задача Объясни, почему Nginx возвращает 502. ## Исходные данные Система: Ubuntu. Приложение работает через PHP-FPM. ## Требования - Сначала предложи проверки без изменения настроек. - Отдели команды от объяснений. - Не предлагай перезапуск без причины. ## Результат Короткий план диагностики с объяснением каждого шага.
Имена файлов и команды лучше выделять отдельно. У строки лога, конфигурации и просьбы автора разный смысл. Если всё смешать в один абзац, труднее и читать, и замечать ошибки. Но блок кода не является защитной границей: написанная внутри него инструкция всё равно может повлиять на ответ модели. Секреты и недоверенные данные требуют отдельных правил обработки.
Компактность полезна, но экономия не гарантирована
После удаления меню, повторяющейся навигации и оформительских тегов текст страницы часто становится короче. В контекст модели помещается больше содержания. Однако Markdown не всегда занимает меньше токенов, чем любой HTML: результат зависит от исходной страницы, преобразования и токенизатора. Фиксированного процента экономии у формата нет.
Не стоит превращать сложную страницу в текст любой ценой. Таблица с объединёнными ячейками, формула, изображение или интерактивная форма могут потерять важную часть смысла. Для таких материалов нужны подходящие представления и подписи, а иногда исходный HTML или сам снимок.
Один Markdown может выглядеть по-разному
CommonMark появился из-за неоднозначностей первоначального описания. Разные реализации по-разному обрабатывали вложенные списки, отступы и сочетания разметки. Поэтому для воспроизводимого результата нужен не только файл с расширением .md, но и известный диалект с конкретным обработчиком.
Например, таблицы с вертикальными чертами привычны в некоторых расширениях, но не относятся к базовому синтаксису CommonMark. Подсветка языка внутри блока кода тоже зависит от программы показа. Перед переносом документа между системами стоит проверить таблицы, ссылки и вложенные списки, а не только первый абзац.
В WordPress Markdown не заменяет блоки редактора
Gutenberg хранит разметку блоков в HTML с комментариями WordPress. Для редактора это рабочий формат. Markdown-версию можно подготовить как дополнительное представление статьи, сохранив заголовки, текст, код и полезные ссылки. При этом должны совпадать содержание и адреса, иначе разные читатели получат разные версии материала.
С этим связан разбор готовности сайта к ИИ-агентам: один llms.txt или переписанный адрес главной страницы ещё не создаёт текстовых копий всех публикаций. Для большого сайта нужна отдельная продуманная выдача материалов, а не просто файл с модным названием.
Markdown удобен тем, что остаётся обычным текстом с понятной структурой. Для работы с нейросетью этого часто достаточно: ясно сформулировать задачу, отделить данные и назвать ожидаемый результат. Проверять факты, права доступа и предложенные команды всё равно приходится отдельно.