Markdown для ИИ: почему простой текст победил

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

Почему не Word и не Notion

Казалось бы, есть куда более «богатые» форматы. Но у markdown есть свойства, которые для баз знаний оказались важнее красоты:

• Его читают все. Человек — в любом редакторе, ИИ — напрямую, без конвертации. Docx для нейросети — это архив с XML внутри; markdown — просто текст.
• Он не привязан к сервису. Notion может изменить тарифы, закрыть доступ или перестать работать в вашей стране. Папка markdown-файлов принадлежит вам и работает без интернета — ваши знания не зависят от чужого сервиса.
• Он дружит с версионированием. Изменения в текстовых файлах легко отслеживать: видно, кто, что и когда поменял.
• Он структурный, но не жёсткий. Заголовки, списки и таблицы дают структуру, которую понимает ИИ, — без схем и баз данных.

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

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

## Раздел

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

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

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

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

Этого хватает для 95% страниц базы знаний. Учиться специально не нужно — вы освоите markdown за десять минут практики.

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

Несколько привычек, которые заметно улучшают ответы нейросети:

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

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

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

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

Для личной wiki это необязательно. Но если страниц становится много, такие «паспорта» позволяют фильтровать и сортировать — именно на этом принципе построен стандарт OKF.

Куда дальше

• Следующий урок: поддержка памяти — как база не устаревает.
• Термин: markdown в словаре.
• Практика: шаблоны — готовые markdown-структуры.