раздел 01
Три формата: когда какой
Правило простое: если в файле есть заголовки и абзацы - это Markdown. Если это строки и колонки - CSV. Если это поток текста без структуры - TXT. Дальше про каждый с примерами и про то, где каждый ломается.
Markdown - для всего, что читают
Markdown придумали, чтобы писать текст с разметкой, не отрывая рук от клавиатуры. Заголовок - решётка в начале строки. Список - дефис. Жирный - две звёздочки вокруг слова. Ссылка - текст в квадратных скобках и адрес в круглых. Таблица - вертикальные черты между ячейками.
Вот документ целиком:
# План обучения: отдел продаж
## Цель
Научить менеджеров готовить КП с агентом за 20 минут вместо двух часов.
## Модули
- Основы: что такое агент в IDE, как ставить задачу
- Практика: три реальных КП из очереди отдела
- Разбор: что получилось, где агент ошибся
## Расписание
| Дата | Модуль | Ведущий |
|---|---|---|
| 12.10 | Основы | Павел |
| 19.10 | Практика | Павел |
| 26.10 | Разбор | команда |
Материалы: [папка курса](https://example.com/course)
Это одновременно читаемый текст (даже без рендера всё понятно) и структура, которую агент распознаёт без подсказок. Он знает, что в файле три раздела, что расписание - таблица из трёх строк, что в модулях три пункта.
Куда Markdown подходит: письма и КП, инструкции и регламенты, планы и протоколы встреч, заметки, статьи, описания проектов, файлы правил для агента (AGENTS.md / CLAUDE.md - в Claude Code тот же файл называется CLAUDE.md).
Где ломается: сложные макеты в две колонки, точное позиционирование, вложенные таблицы, таблицы с объединёнными ячейками. Если документ держится на оформлении, Markdown его упростит.
CSV - для всего, что считают
CSV расшифровывается как comma-separated values: значения через запятую. Одна строка файла - одна запись. Первая строка - названия колонок. Всё.
date,client,module,hours,amount
2026-09-12,МирКли,Основы,8,120000
2026-09-19,МирКли,Практика,16,240000
2026-09-26,СФТ,Основы,8,120000
Агент такое читает мгновенно и сразу может: посчитать сумму по клиенту, отфильтровать по дате, найти дубли, построить сводную. Excel для этого не нужен - обычный Python-скрипт или даже прямой подсчёт в голове модели.
Куда подходит: выгрузки из CRM и банка, реестры клиентов и договоров, списки участников, прайсы, любые «плоские» таблицы, где одна строка - одна сущность.
Где ломается: несколько листов в одном файле (CSV - это один лист), формулы (в CSV хранятся только значения), запятые внутри значений (тогда значение берут в кавычки, и не все инструменты это делают одинаково), кодировка (Excel на Windows любит сохранять не в UTF-8, и кириллица превращается в кракозябры).
TXT - для всего остального
Обычный текст без разметки. Ни заголовков, ни таблиц, ни ссылок в специальном виде. Только символы и переводы строк.
[00:00:04] Павел: Давайте начнём с того, что у вас сейчас болит.
[00:00:11] Оксана: Больше всего времени уходит на КП. Каждое пишем с нуля.
[00:00:19] Павел: Сколько в неделю?
[00:00:21] Оксана: Пять-семь. Это по два часа на каждое.
Куда подходит: транскрипты встреч и звонков, логи программ, дампы переписки, сырые выгрузки текста из PDF, черновики, которые ещё не приобрели структуру.
Где ломается: когда структура всё-таки есть, а вы её не разметили. Агент прочитает транскрипт на 40 страниц, но чтобы найти «раздел про бюджет», ему придётся угадывать. Один час на расстановку ## по темам - и поиск станет точным.
Сомневаетесь между TXT и Markdown - берите Markdown. Файл без разметки в нём остаётся валидным, а добавить пару заголовков можно потом.
Сравнение
| Markdown | CSV | TXT | |
|---|---|---|---|
| Что хранит | Текст с заголовками, списками, таблицами, ссылками | Плоскую таблицу: строки и колонки | Голый текст |
| Чем открыть | Любой редактор, IDE, браузер с рендером, Obsidian | Любой редактор, Excel, Google Sheets, pandas | Любой редактор |
| Как выглядит для человека | Читаемо даже без рендера | Читаемо при малом числе колонок | Читаемо |
| Как выглядит для агента | Структура видна сразу | Структура видна сразу | Структуру надо вычитывать |
| Где ломается | Сложные макеты, объединённые ячейки | Формулы, несколько листов, кодировка | Большие объёмы без разметки |
| Заменяет | Word, Google Docs, Pages | Excel, Google Sheets (один лист) | Notepad, заметки, логи |
Что теряется при переходе из Word и Excel
Честный список:
- Оформление: шрифты, цвета, отступы, поля страницы, колонтитулы. В Markdown есть только смысловая разметка.
- Формулы Excel. CSV хранит результат, не формулу. Если в таблице половина ячеек считается от других - при экспорте останутся числа.
- Макросы и скрипты внутри файла.
- Комментарии и режим правок Word. В md комментарии можно писать прямо в тексте, а правки видны через git, но это другой процесс.
- Встроенные картинки и диаграммы. Картинки выносятся в отдельную папку и подключаются ссылкой, диаграммы - как картинки или как данные в CSV.
- Несколько листов в одной книге Excel. Каждый лист станет отдельным CSV.
Почему это чаще неважно: агент работает со смыслом. Ему нужен текст письма; каким шрифтом оно набрано, для задачи безразлично. Из таблицы ему нужны цифры, формулу =B2*C2 он воспроизведёт сам и покажет, как считал. Комментарии рецензентов можно вынести в отдельный раздел «Замечания». Если что-то из потерянного критично - это сигнал, что документ живёт в двух версиях: лёгкой для работы и тяжёлой для выдачи. Как это устроить - в главе 04.
Частые ошибки
- Хранить таблицу в Markdown, когда в ней 30 колонок и 500 строк. Это CSV.
- Хранить в CSV что-то, где есть абзацы текста. Это Markdown с таблицей или несколько файлов.
- Сохранить CSV из Excel без проверки кодировки и получить кириллицу вопросиками.
- Оставить транскрипт на 100 страниц в TXT и удивляться, что агент «не нашёл» нужный фрагмент.
- Пытаться воспроизвести в Markdown макет фирменного бланка. Бланк - для выдачи, соберётся в конце.