Что такое md файлы

md — это текстовый файл в формате Markdown.
По сути это обычный текст, где простые символы задают структуру: заголовки, списки, ссылки и фрагменты кода.

Markdown используют там, где важны скорость и читаемость: в README.md, документации, конспектах и технических инструкциях.

Пример:

# Заголовок

Короткое описание задачи.

## Шаги
- Установить зависимости
- Запустить проект

Команда: `npm run dev`

Чем md отличается от txt:
в txt это просто текст, а в md текст с понятной разметкой, которая корректно отображается на GitHub, GitLab и в редакторах.

Если коротко: md — стандартный формат для документации в разработке, потому что его легко писать, читать и хранить в Git.

MD-файл — текстовый файл в формате Markdown. Расширение .md — сокращение от Markdown. Внутри обычный текст, где символы #, *, - задают заголовки, выделение и списки. Программы показывают такой файл отформатированным.

# Заголовок

Обычный абзац с **жирным** и *курсивным* словом.

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

[Ссылка на Хекслет](https://ru.hexlet.io)

Где встречаются md-файлы

• README.md — описание проекта на GitHub и GitLab. Его показывают на главной странице репозитория.
• Инструкции для ИИ-агентов: CLAUDE.md для Claude Code, AGENTS.md для Codex и других агентов, файлы правил Cursor. Агент читает их перед работой.
• Документация: сайты на MkDocs, Docusaurus, VitePress собирают из md-файлов.
• Заметки в Obsidian и других редакторах заметок.

Как открыть md-файл

Подойдёт любой текстовый редактор: Блокнот, TextEdit, VS Code. Чтобы увидеть оформление:

• в VS Code откройте файл и нажмите Ctrl + Shift + V (на macOS Cmd + Shift + V) — откроется предпросмотр;
• загрузите файл на GitHub — он покажет его отформатированным;
• откройте в Obsidian или Typora.

Основная разметка

Почему ИИ-агенты работают с md

Markdown читается как обычный текст, поэтому его одинаково понимают люди и языковые модели. Структура из заголовков и списков помогает агенту найти нужное правило. Файлы лежат в репозитории рядом с кодом и меняются через Git.

Пример CLAUDE.md:

# Проект

- Python 3.12, зависимости ставим через uv
- Тесты: `make test`, запускать перед каждым коммитом
- Комментарии в коде на русском

Как писать инструкции для ИИ-агентов, разбирают на курсе «Вайб-кодинг на Claude Code». Git и README — в бесплатном курсе «Основы Git».