developer
•
7 мин чтения
•
Обновлено: 2026-09-20
Markdown: разметка текста от заголовков до таблиц и блоков кода
Markdown — легковесный язык разметки, изобретённый Джоном Грубером в 2004 году для написания текста, который читается как простой текст, но при рендеринге превращается в структурированный HTML. Сегодня Markdown стал стандартом де-факто для README в GitHub, документации в Confluence, постов в Reddit и статей в Ghost CMS.
Заголовки, параграфы и горизонтальные разделители
Заголовки создаются символом # в начале строки. Количество символов # определяет уровень (от H1 до H6):
# Заголовок первого уровня (H1)
## Заголовок второго уровня (H2)
### H3 — используется в большинстве документов
Параграфы разделяются пустой строкой. Одиночный перенос строки внутри параграфа не создаёт новый абзац в HTML — это особенность спецификации CommonMark.
Горизонтальная линия (тег <hr>) создаётся тремя или более дефисами, звёздочками или подчёркиваниями на отдельной строке:
---
ИЛИ
***
# Заголовок первого уровня (H1)
## Заголовок второго уровня (H2)
### H3 — используется в большинстве документов
Параграфы разделяются пустой строкой. Одиночный перенос строки внутри параграфа не создаёт новый абзац в HTML — это особенность спецификации CommonMark.
Горизонтальная линия (тег <hr>) создаётся тремя или более дефисами, звёздочками или подчёркиваниями на отдельной строке:
---
ИЛИ
***
Форматирование текста: жирный, курсив, зачёркнутый, код
• Жирный текст — двойные звёздочки или двойные подчёркивания: жирный или __жирный__
• *Курсив* — одна звёздочка или подчёркивание: *курсив* или _курсив_
• *Жирный курсив* — тройные звёздочки
• ~~Зачёркнутый~~ — двойные тильды (GitHub Flavored Markdown, GFM)
•
Важный нюанс: в русском тексте подчёркивания для курсива работают непредсказуемо, если слово содержит кириллицу в середине. Рекомендуется использовать звёздочки.
• *Курсив* — одна звёздочка или подчёркивание: *курсив* или _курсив_
• *Жирный курсив* — тройные звёздочки
• ~~Зачёркнутый~~ — двойные тильды (GitHub Flavored Markdown, GFM)
•
Инлайн-код — одинарные обратные апострофы: console.log('hello')Важный нюанс: в русском тексте подчёркивания для курсива работают непредсказуемо, если слово содержит кириллицу в середине. Рекомендуется использовать звёздочки.
Списки, ссылки и изображения
Ненумерованный список — дефис, звёздочка или + в начале строки:
- Первый пункт
- Второй пункт
- Вложенный (2 пробела или таб перед -)
Нумерованный список — цифра с точкой:
1. Первый шаг
2. Второй шаг
Ссылки: [текст ссылки](https://example.com) или [текст][метка] с блоком [метка]: url в конце документа.
Изображения аналогичны ссылкам, но со знаком ! в начале: 
Для вставки ссылки с title (всплывающей подсказкой): [текст](url "Подсказка при наведении")
- Первый пункт
- Второй пункт
- Вложенный (2 пробела или таб перед -)
Нумерованный список — цифра с точкой:
1. Первый шаг
2. Второй шаг
Ссылки: [текст ссылки](https://example.com) или [текст][метка] с блоком [метка]: url в конце документа.
Изображения аналогичны ссылкам, но со знаком ! в начале: 
Для вставки ссылки с title (всплывающей подсказкой): [текст](url "Подсказка при наведении")
Таблицы GFM и блоки кода с языком
Таблицы — расширение GitHub Flavored Markdown (GFM), не входящее в базовую спецификацию Gruber:
| Столбец 1 | Столбец 2 | Столбец 3 |
|-----------|:---------:|----------:|
| Лево | Центр | Право |
| Ячейка | Ячейка | Ячейка |
Двоеточие в строке разделителя задаёт выравнивание: :--- влево, :---: по центру, ---: вправо.
Блоки кода с синтаксической подсветкой (в поддерживающих рендерерах):
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.
| Столбец 1 | Столбец 2 | Столбец 3 |
|-----------|:---------:|----------:|
| Лево | Центр | Право |
| Ячейка | Ячейка | Ячейка |
Двоеточие в строке разделителя задаёт выравнивание: :--- влево, :---: по центру, ---: вправо.
Блоки кода с синтаксической подсветкой (в поддерживающих рендерерах):
`pythondef fibonacci(n):
a, b = 0, 1
for _ in range(n):
a, b = b, a + b
return a
`После открывающих трёх апострофов указывается название языка: python, javascript, bash, sql, php, json, css.
Попробуйте онлайн-инструменты по этой теме
Используйте бесплатные утилиты Utilora прямо в браузере без регистрации:
Markdown to HTML
Мгновенное преобразование разметки Markdown в чистый HTML с интерактивным живым превью и подсчётом статистики.
Запустить ▸JSON Formatter
Форматирование с отступами в 2 или 4 пробела, сжатие и перевод JSON в одну строку (Minify), валидация синтаксиса.
Запустить ▸Счётчик слов
Быстрый подсчёт количества слов, символов, абзацев и времени чтения текста.
Запустить ▸