Основы · Блог

Что такое Markdown и файл .md

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

Обложка статьи «Что такое Markdown и файл .md»: локап ProsaMD, заголовок и подзаголовок «Markdown — текст, который читается как документ», рубрика «Основы · № 01»

Разметка, которая читается как текст

Markdown придумали в 2004 году Джон Грубер и Аарон Шварц: нужен был формат, который удобно и писать, и читать без специальных программ. Идею частично подсказали соглашения электронных писем — звёздочки вокруг слова люди понимали как выделение и раньше.

Суть — символы вместо кнопок и тегов:

Что пишетеЧто получаете
# Титулзаголовок первого уровня
- пунктэлемент списка
**важно**полужирный текст
`код`выделенный фрагмент кода
> мысльцитата
Файл .md: слева разметка как текст, справа тот же файл как готовый документ Markdown
Один и тот же файл .md: слева — разметка, которую пишет человек; справа — тот же файл, который показывает программа с поддержкой Markdown.

По-русски формат часто называют «маркдаун» — это то же самое. Расширение привычных вариаций — GFM, «GitHub Flavored Markdown»: таблицы, чек-листы и зачёркивание, которые понимает GitHub. Полный синтаксис с примерами — в справочнике синтаксиса.

Файл .md: что у него внутри

Расширение .md означает ровно одно: внутри — текст с этой разметкой. Особого формата нет. Откройте такой файл в Блокноте — увидите символы; откройте в программе с поддержкой Markdown — увидите готовый документ.

Пример настоящего файла:

Код
# Заметки о запуске

Черновик в **ProsaMD** — редактор, который не мешает писать.

- [x] Открыть .md-файл
- [ ] Рассказать миру

> Файл — просто файл. На диске.

Этот фрагмент можно переслать, положить в git, открыть на любой системе — разметка не «сломается», потому что ломаться нечему: это буквы. Так README проектов и документация живут в git-репозиториях рядом с кодом.

Как разметка превращается в документ

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

В ProsaMD один и тот же файл живёт в четырёх режимах: «Просмотр» показывает документ как статью, «Визуальный» собирает страницу прямо при вводе, «Код» открывает разметку как есть, а «Сплит» держит код и превью рядом. Переключение — одно нажатие Ctrl+/.

Файл примера в ProsaMD: Просмотр → правка в Визуальном → разметка в Коде → снова Просмотр. Одно нажатие Ctrl+/ на каждый переход. 19 секунд, без звука.

Двойной щелчок по файлу — и документ уже готов: читайте, правьте, сохраняйте. С версии 0.1.10 ProsaMD сохраняет файл байт в байт: что открыли, то и запишется на диск, без переписывания разметки по-своему.

Где вы уже встречали Markdown

Формат давно вышел за пределы программистов. README на GitHub, документация, заметки, статьи — всё это Markdown. Инструкции для ИИ-помощников, вроде AGENTS.md и CLAUDE.md, тоже пишутся в нём. Если вы правили страницу на GitHub — вы уже писали на этой разметке.

Чем это отличается от Word и HTML: Word хранит оформление внутри собственного файла, HTML описывает страницу тегами. Эта разметка остаётся текстом, который читает человек и любая программа — а при необходимости её переводят в HTML, PDF или документ Word.

Что показывает ProsaMD — и чего пока нет

ProsaMD — бесплатный редактор и просмотрщик Markdown для Windows и Linux с открытым кодом; установщик — около 4 МБ. Программа показывает всё, что вы встретите в README на GitHub и в шпаргалках: заголовки, списки, чек-листы, таблицы, зачёркивание, сноски, картинки и front-matter.

Пока не показываются диаграммы Mermaid — поддержка задумана плагином в планах v0.3; формулы (KaTeX) работают в визуальном режиме.

Частые вопросы

Чем открыть файл .md?

Файл .md откроет любой текстовый редактор, включая Блокнот: внутри — обычный текст. Готовым документом его показывают программы с поддержкой Markdown и расширения браузера. ProsaMD открывает .md двойным щелчком и работает в Windows и Linux.

Чем Markdown отличается от HTML и Word?

Markdown отличается от HTML и Word тем, что остаётся обычным текстом: оформление набирают символами, а не тегами и не кнопками. Word хранит оформление внутри файла, HTML описывает страницу тегами, а Markdown читается без программ — и переводится и в HTML, и в Word.

Кто придумал Markdown и когда?

Markdown создали в 2004 году Джон Грубер и Аарон Шварц; идеи разметки частично заимствованы из соглашений оформления электронных писем.

Что такое GFM?

GFM (GitHub Flavored Markdown) — распространённое расширение Markdown, которое добавило таблицы, чек-листы и зачёркивание. Его понимает GitHub; ProsaMD показывает таблицы, чек-листы и зачёркивание GFM как обычные элементы документа.

Можно ли испортить файл .md, открыв его в программе?

Пока вы не сохраняете файл, на диске ничего не меняется. Опасна программа, которая при сохранении сама переписывает разметку; ProsaMD с версии 0.1.10 сохраняет файл байт в байт.

Открыть пример в ProsaMD

Скачайте файл примера и откройте его в ProsaMD — разметка из статьи превратится в готовый документ. Бесплатно и открыто · установщик около 4 МБ · Windows и Linux