Поиск

Markdown для работы с ИИ: зачем нужен простой текст

Markdown — способ размечать текст простыми символами: # для заголовка, - для списка, **жирный** для выделения. Такой файл остаётся обычным текстом. Его можно открыть в простом редакторе, хранить рядом с проектом и передавать между разными инструментами.

Почему markdown удобен человеку и ИИ

  1. Текст виден без специальной программы. Человек может прочитать файл напрямую, а ИИ получает содержимое вместе со структурой заголовков и списков.
  2. Файлы остаются переносимыми. Их можно перенести в другой редактор, хранилище или проект без экспорта всей платформы.
  3. Изменения легко сравнивать. В системе контроля версий видно, какая строка поменялась. Это особенно полезно, если правки предлагает ИИ.
  4. Структуры обычно достаточно. Заголовки, списки, таблицы и ссылки подходят для регламентов, заметок, карточек проектов и решений.

Минимум, который нужно знать

# Заголовок страницы

## Раздел

Обычный текст. **Важное** выделяем жирным.

- пункт списка
- ещё пункт

| Колонка | Колонка |
|---------|---------|
| данные  | данные  |

[Ссылка на другую страницу](другая-страница.md)

Для первой страницы этого набора достаточно.

Как писать страницы, удобные для ИИ

Несколько правил упрощают чтение и проверку:

  1. Один файл — одна тема. Страница «Клиент X» лучше, чем «Всякое про клиентов».
  2. Заголовки по смыслу. ИИ ориентируется по заголовкам так же, как человек по оглавлению.
  3. Факты — списками и таблицами. Тариф, срок, условие — в таблицу, а не в абзац художественного текста.
  4. Пишите даты явно. «Актуально на июль 2026» полезнее, чем «сейчас».
  5. Ссылки между страницами. Связанная страница — это подсказка, где искать продолжение.

YAML frontmatter: паспорт страницы

В начало файла можно добавить блок с данными о странице — это называется frontmatter:

---
title: Клиент X
type: клиент
updated: 2026-07-02
tags: [опт, москва]
---

Для небольшой личной папки frontmatter необязателен. Когда страниц становится много, такие поля помогают сортировать материалы и находить устаревшие записи. Похожую схему использует OKF.

Сначала файлы или платформа

Сначала проверьте, кому нужны материалы и как они будут обновляться. Если важны переносимость, история изменений и работа рядом с техническим проектом, текстовые файлы удобны. Если команде нужен визуальный редактор, совместные комментарии или сложные права доступа, лучше выбрать сервис, который это поддерживает. В обоих случаях заранее продумайте экспорт и резервную копию.

История файлового подхода, гист Андрея Карпаты и Open Knowledge Format разобраны на странице первоисточников.

Другие материалы