Markdown — лёгкий язык разметки для форматирования текста с помощью простых читаемых символов. Создан для того, чтобы писать структурированные документы в plain-text формате, который легко конвертируется в HTML и другие форматы. Расширение файлов — .md или .markdown, MIME-тип — text/markdown (RFC 7763).

История

Markdown был создан Джоном Грубером (John Gruber) при участии Аарона Шварца (Aaron Swartz) и выпущен 9 марта 2004 года. Последняя версия оригинала — 1.0.1 (17 декабря 2004). Грубер описывал его так:

«Markdown — это инструмент преобразования текста в HTML для веб-писателей. Markdown позволяет вам писать в легко читаемом и легко записываемом формате plain text, а затем преобразовывать его в структурно валидный XHTML (или HTML).»

Изначально Markdown был реализован как Perl-скрипт (Markdown.pl). За два десятилетия появились десятки реализаций на разных языках программирования, а также множество расширений и диалектов.

Синтаксис

Элемент Синтаксис Markdown Результат

Заголовок уровня 1

# Заголовок

Заголовок

Заголовок уровня 2

## Заголовок

Заголовок

Заголовок уровня 3

### Заголовок

Заголовок

Жирный текст жирный жирный

Курсив курсив курсив

Моноширинный код `код` код

Блок кода

``` язык (в три обратных апострофа)

<code>блок кода</code>

Ссылка [текст](url) <a href="url">текст</a>

Изображение ![alt](url) <img src="url" alt="alt">

Маркированный список

* элемент

элемент

Нумерованный список

1. элемент

элемент

Горизонтальная линия

---

Цитата

> текст

текст

Таблица

col1 \| col2 \| (GFM)

col1

col2

Пример полного документа:

# Моя статья

Это **жирный** и *курсив* текст.

* Пункт списка 1
* Пункт списка 2

> Цитата автора

[Ссылка на сайт](https://example.com)

```python
print("Hello, Markdown!")
```

Стандартизация

CommonMark

Из-за множества несовместимых реализаций в 2014 году Джон МакФарлейн (John MacFarlane) и другие участники начали работу над CommonMark — строгой спецификацией Markdown с набором тестов. Текущая версия — 0.31.2 (28 января 2024).

CommonMark охватывает базовый синтаксис: заголовки, списки, код, ссылки, изображения, цитаты, экранирование. Особенности:

Fenced code blocks (блоки кода в ```) — включены в ядро
Видимый синтаксис для переноса строк — две пробела в конце строки
Строгие правила вложенности списков
Единый парсер с эталонной реализацией

GitHub Flavored Markdown (GFM)

GFM — строгий суперсет CommonMark, используемый на GitHub и GitHub Enterprise. Версия спецификации — 0.29-gfm (2019). Добавляет:

Таблицы
Зачёркнутый текст (~~текст~~)
Автоссылки (URL автоматически становятся ссылками)
Списки задач (- [x])
Эмодзи (:smile:)
Подсветка синтаксиса в блоках кода

Другие диалекты

MultiMarkdown — расширение для сносок, определений, математики
Markdown Extra — добавлены таблицы, сноски, атрибуты HTML-элементов
Pandoc Markdown — самый богатый диалект: поддержка LaTeX-математики, сносок, библиографий, cross-references
RMarkdown — интеграция с языком R для динамических отчётов

Применение

Markdown используется повсеместно:

Документация — README.md на GitHub/GitLab, документация проектов (Docusaurus, MkDocs, VuePress)
Форумы и соцсети — Reddit, Discord, Telegram, WhatsApp (частично), Notion, Obsidian
LLM-чаты — ChatGPT, Claude, Gemini используют Markdown для форматирования ответов
Статические сайты — Jekyll, Hugo, Next.js, Astro (через MDX)
Техническое письмо — научные статьи, книги (через Pandoc), слайды (Marp, Slidev)
Блокноты — Jupyter Notebook (.ipynb) использует Markdown для текстовых ячеек
AI/LLM-агенты — сервисы типа r.jina.ai возвращают Markdown как универсальный формат для подачи в LLM

Инструменты 2026 года

Редакторы

Инструмент	Платформа	Особенности
Obsidian	Windows/macOS/Linux	База знаний на Markdown, граф связей
VS Code	Windows/macOS/Linux	Встроенный редактор + расширения
Typora	Windows/macOS	WYSIWYM-редактор
CyberWriter	macOS	Нативный редактор с локальным AI (Apple 3B)
Attn	Linux/macOS	Редактор на Rust для AI-агентов (<20MB)
Logseq	Windows/macOS/Linux	Outliner с Markdown-блоками
Zettlr	Windows/macOS/Linux	Академический Markdown-редактор

Парсеры и конвертеры

Pandoc — универсальный конвертер (Markdown ↔ HTML, PDF, DOCX, LaTeX, EPUB и десятки других форматов)
marked — быстрый JavaScript-парсер
remark/rehype — экосистема плагинов для Markdown (unified)
markdown-it — гибкий парсер с поддержкой плагинов
md4c — эталонный C-парсер CommonMark
Python-Markdown — стандартный парсер для Python
mistune — быстрый Python-парсер (C-расширение)

CI/CD и статические сайты

Docusaurus — от Meta, генератор документации на React + MDX
MkDocs — Python-генератор документации
Hugo — самый быстрый генератор статических сайтов
Next.js MDX — React-компоненты в Markdown-файлах

Преимущества и недостатки

Преимущества:

Читаемость в исходном виде — Markdown понятен без рендеринга
Простота — выучить можно за 5 минут
Универсальность — работает везде: GitHub, LLM, редакторы, сайты
Расширяемость — сотни диалектов и плагинов

Недостатки:

Отсутствие единого стандарта — до CommonMark диалекты были несовместимы
Ограниченные возможности — не подходит для сложной вёрстки
Безопасность — возможна XSS через HTML-инъекции в некоторых парсерах
Отсутствие поддерки переменных, включений, условной логики (в сравнении с AsciiDoc)

Будущее

В 2026 году Markdown остаётся доминирующим форматом для документации, AI-выводов и технического письма. AsciiDoc набирает популярность в сложных документационных проектах, но Markdown удерживает позиции благодаря простоте и широчайшей экосистеме. CommonMark продолжает развиваться, а GFM остаётся де-факто стандартом для разработчиков.

Ссылки

×

Что такое Markdown разметка - 2026

Содержание

История

Синтаксис

Заголовок

Заголовок

Заголовок

Стандартизация

CommonMark

GitHub Flavored Markdown (GFM)

Другие диалекты

Применение

Инструменты 2026 года

Редакторы

Парсеры и конвертеры

CI/CD и статические сайты

Преимущества и недостатки

Будущее

Ссылки