Что такое файл .md? Объяснение простыми словами

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

Markdown в одном абзаце

Большинство знакомых вам документов, например файлы Word и PDF, хранят оформление в скрытом слое, которого вы не видите. Markdown делает наоборот: оформление записано прямо в тексте обычными символами с клавиатуры. Файл — это просто текст, поэтому его откроет любой компьютер, он почти ничего не весит и будет читаться и через тридцать лет. Цена этого: нужно приложение, которое прочитает символы и превратит их в оформление, иначе вы видите их как есть.

Кто его придумал и зачем

Markdown создал Джон Грубер, автор блога Daring Fireball, и выпустил в 2004 году при большом участии программиста Аарона Шварца. Груберу нужен был способ писать для веба, не набирая HTML, и главным правилом он сделал такое: документ Markdown должен читаться как есть, простым текстом, и не выглядеть так, будто его усыпали командами форматирования.

Поэтому символы взяты из привычек, которые у людей уже были в текстовой переписке, например звёздочки вокруг слова для выделения. Вот почему сырой файл .md, при всём его шуме, всё-таки читается.

Позже другие люди добавили то, чего не хватало оригиналу. Самая распространённая сегодня версия — GitHub Flavored Markdown, в ней появились таблицы, списки дел и зачёркивание. Говоря «Markdown», обычно имеют в виду её.

Почему ИИ пишет в Markdown

Когда ChatGPT, Claude, Gemini или Copilot отвечает вам, текст обычно написан в Markdown. Вы этого почти не замечаете, потому что окно чата превращает символы в заголовки, полужирный текст и таблицы раньше, чем вы их увидите. Формат им подходит: он компактный, переживает копирование между приложениями и часто встречается в технических текстах, на которых эти инструменты учились.

Сложности начинаются, когда ответ покидает чат. Попросите «файл» и получите .md: тот же текст вместе с символами, и превращать их уже нечему. Скопируйте ответ в приложение, которое не понимает Markdown, и звёздочки приедут вместе с ним.

Что означают символы

Вот те, что встречаются почти в каждом документе, написанном ИИ.

В файле вы видите	Что это значит
`# Название`	Главный заголовок
`## Раздел`, `### Подраздел`	Заголовки поменьше: чем больше `#`, тем мельче заголовок
`важно`	Полужирный: важно
`заметка` или `_заметка_`	Курсив: заметка
`- пункт` или `* пункт`	Маркированный список
`1. пункт`	Нумерованный список
`- [ ] задача` и `- [x] готово`	Список дел: пустой флажок и отмеченный
`[отчёт](https://example.com)`	Ссылка: слова в квадратных скобках, адрес в круглых
`> цитата`	Цитата, показывается с отступом
`код`	Технический термин или кусочек кода моноширинным шрифтом
Три обратных апострофа на отдельной строке	Начало или конец блока кода
Строки слов, разделённых вертикальными чертами	Таблица (см. ниже)

Таблицы в сыром виде пугают больше всего, поэтому вот пример:

| Товар  | Цена |
| ------ | ---- |
| Кофе   | 300  |
| Пирог  | 400  |

Первая строка — шапка, строка из дефисов отделяет её от остального, каждая следующая строка — ряд таблицы. Черты показывают, где кончается один столбец и начинается другой. В нормальном отображении это маленькая обычная таблица из двух столбцов и двух строк.

Изредка встречаются и другие: ~~текст~~ для зачёркивания, --- на отдельной строке для разделительной линии и ![описание](картинка.png) для изображения. Этим почти всё и исчерпывается.

Почему Mac показывает символы

В macOS нет встроенного приложения для чтения Markdown. Для системы файл .md — простой текст, поэтому двойной щелчок открывает его в том, что отвечает за простой текст: обычно в TextEdit или в Xcode, если установлены инструменты разработчика Apple. Оба показывают ровно то, что есть в файле, вместе с символами. Пробел в Finder делает то же самое, если никакое приложение не добавило предпросмотр Markdown. Файл в порядке, Mac просто не знает, как его показать.

Как открыть его нормально

Один раз, ничего не устанавливая: откройте в TextEdit и читайте, не обращая внимания на символы. Терпимо для короткой заметки, мучительно для длинной таблицы.
В облаке: Google Документы открывают файл .md, если загрузить его на Google Диск. Это работает, но файл придётся куда-то загрузить, и для личного документа это стоит обдумать.
В редакторе кода: VS Code показывает оформленный предпросмотр по ⇧⌘V. Работает, но это инструмент программиста и выглядит соответственно.
В приложении для Markdown: Hem — бесплатное приложение для Mac с открытым кодом, сделанное именно для этого. При первом запуске оно предлагает стать приложением для файлов .md. После этого двойной щелчок показывает оформленную страницу, а пробел в Finder — оформленный предпросмотр. Файл остаётся на вашем Mac. Hem есть только для Mac.

Файл .md открыт в Hem: символов нет, в отчёте видны заголовок, таблица, список и нумерованные шаги.

Если файл выдал ИИ-чат, с этого места начните со статьи ChatGPT выдал файл .md.

Как его править

Изменить файл .md может любой текстовый редактор, ведь это только текст. Но править придётся символы: чтобы сделать слово полужирным, нужно набрать по две звёздочки с каждой стороны, а результат проверять в предпросмотре.

Если учить это не хочется, возьмите приложение, которое прячет символы во время работы. В Hem вы щёлкаете в оформленной странице и печатаете, почти как в Pages или Word. При выделении текста появляется небольшая панель: полужирный, курсив, заголовки, списки, списки дел, ссылки и цитаты. ⌘B и ⌘I работают как обычно, «Формат» › «Вставить таблицу» добавляет таблицу, флажки отмечаются щелчком. Hem сохраняет изменения в тот же файл .md и переписывает только то, что вы изменили. Файл остаётся обычным Markdown, который прочитает ИИ и любое другое приложение.

Как его конвертировать

В Word: в Hem «Файл» › «Экспортировать в Word…» сохраняет .docx. Другие способы, включая Google Документы, описаны в статье как превратить .md в документ Word на Mac.
В PDF: «Файл» › «Экспортировать в PDF…» в Hem.
В письмо или другой документ: скопируйте из Hem (⌘C) и вставьте в Почту, Word, Pages или Google Документы. Заголовки, полужирный текст, списки и таблицы придут оформлением, а не символами.
Обратно ИИ: конвертировать не нужно. ИИ-чаты спокойно читают Markdown, так что вставьте текст или прикрепите файл .md как есть.

Коротко

Файл .md — это текстовый документ, оформление которого записано символами. Он не сломан, не опасен и нужен не только программистам. Ему просто требуется приложение, которое читает символы, и на Mac его придётся установить, потому что встроенного нет.