developer 7 мин чтения Обновлено: 2026-09-20

Markdown: разметка текста от заголовков до таблиц и блоков кода

Markdown — легковесный язык разметки, изобретённый Джоном Грубером в 2004 году для написания текста, который читается как простой текст, но при рендеринге превращается в структурированный HTML. Сегодня Markdown стал стандартом де-факто для README в GitHub, документации в Confluence, постов в Reddit и статей в Ghost CMS.

Заголовки, параграфы и горизонтальные разделители

Заголовки создаются символом # в начале строки. Количество символов # определяет уровень (от H1 до H6):

# Заголовок первого уровня (H1)
## Заголовок второго уровня (H2)
### H3 — используется в большинстве документов

Параграфы разделяются пустой строкой. Одиночный перенос строки внутри параграфа не создаёт новый абзац в HTML — это особенность спецификации CommonMark.

Горизонтальная линия (тег <hr>) создаётся тремя или более дефисами, звёздочками или подчёркиваниями на отдельной строке:
---
ИЛИ
***

Форматирование текста: жирный, курсив, зачёркнутый, код

Жирный текст — двойные звёздочки или двойные подчёркивания: жирный или __жирный__
• *Курсив* — одна звёздочка или подчёркивание: *курсив* или _курсив_
*Жирный курсив* — тройные звёздочки
• ~~Зачёркнутый~~ — двойные тильды (GitHub Flavored Markdown, GFM)
Инлайн-код — одинарные обратные апострофы: console.log('hello')

Важный нюанс: в русском тексте подчёркивания для курсива работают непредсказуемо, если слово содержит кириллицу в середине. Рекомендуется использовать звёздочки.

Списки, ссылки и изображения

Ненумерованный список — дефис, звёздочка или + в начале строки:
- Первый пункт
- Второй пункт
- Вложенный (2 пробела или таб перед -)

Нумерованный список — цифра с точкой:
1. Первый шаг
2. Второй шаг

Ссылки: [текст ссылки](https://example.com) или [текст][метка] с блоком [метка]: url в конце документа.
Изображения аналогичны ссылкам, но со знаком ! в начале: ![alt текст](https://example.com/img.jpg)

Для вставки ссылки с title (всплывающей подсказкой): [текст](url "Подсказка при наведении")

Таблицы GFM и блоки кода с языком

Таблицы — расширение GitHub Flavored Markdown (GFM), не входящее в базовую спецификацию Gruber:
| Столбец 1 | Столбец 2 | Столбец 3 |
|-----------|:---------:|----------:|
| Лево | Центр | Право |
| Ячейка | Ячейка | Ячейка |

Двоеточие в строке разделителя задаёт выравнивание: :--- влево, :---: по центру, ---: вправо.

Блоки кода с синтаксической подсветкой (в поддерживающих рендерерах):
`python
def fibonacci(n):
a, b = 0, 1
for _ in range(n):
a, b = b, a + b
return a
`
После открывающих трёх апострофов указывается название языка: python, javascript, bash, sql, php, json, css.
← Все руководства
Скопировано в буфер обмена!