Синтаксис Markdown: шпаргалка и правила разметки текста
Markdown — легковесный язык разметки, изобретённый Джоном Грубером в 2004 году для написания текста, который читается как простой текст, но при рендеринге превращается в структурированный HTML. Сегодня Markdown стал стандартом де-факто для README в GitHub, документации в Confluence, постов в Reddit и статей в Ghost CMS.
Заголовки, параграфы и горизонтальные разделители
# Заголовок первого уровня (H1)
## Заголовок второго уровня (H2)
### H3 — используется в большинстве документов
Параграфы разделяются пустой строкой. Одиночный перенос строки внутри параграфа не создаёт новый абзац в HTML — это особенность спецификации CommonMark.
Горизонтальная линия (тег <hr>) создаётся тремя или более дефисами, звёздочками или подчёркиваниями на отдельной строке:
---
ИЛИ
***
Полезный инструмент: Мгновенно скомпилировать текст разметки в семантический HTML позволяет наш конвертер Markdown в HTML.
Полезный инструмент: Перед версткой текста рекомендуется прогнать его через типографическую обработку текста.
Форматирование текста: жирный, курсив, зачёркнутый, код
• *Курсив* — одна звёздочка или подчёркивание: *курсив* или _курсив_
• *Жирный курсив* — тройные звёздочки
• ~~Зачёркнутый~~ — двойные тильды (GitHub Flavored Markdown, GFM)
•
Инлайн-код — одинарные обратные апострофы: console.log('hello')Важный нюанс: в русском тексте подчёркивания для курсива работают непредсказуемо, если слово содержит кириллицу в середине. Рекомендуется использовать звёздочки.
Списки, ссылки и изображения
- Первый пункт
- Второй пункт
- Вложенный (2 пробела или таб перед -)
Нумерованный список — цифра с точкой:
1. Первый шаг
2. Второй шаг
Ссылки: [текст ссылки](https://example.com) или [текст][метка] с блоком [метка]: url в конце документа.
Изображения аналогичны ссылкам, но со знаком ! в начале: 
Для вставки ссылки с title (всплывающей подсказкой): [текст](url "Подсказка при наведении")
Таблицы GFM и блоки кода с языком
| Столбец 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.
Попробуйте онлайн-инструменты по этой теме
Используйте бесплатные утилиты Utilora прямо в браузере без регистрации:
Markdown to HTML
Мгновенное преобразование разметки Markdown в чистый HTML с интерактивным живым превью и подсчётом статистики.
Запустить ▸JSON Formatter
Форматирование с отступами в 2 или 4 пробела, сжатие и перевод JSON в одну строку (Minify), валидация синтаксиса.
Запустить ▸Счётчик слов
Быстрый подсчёт количества слов, символов, абзацев и времени чтения текста.
Запустить ▸Часто задаваемые вопросы (FAQ)
Оригинальный Markdown 2004 года не поддерживал таблицы, чек-боксы задач (- [x]), блоки кода с указанием языка подсветки и зачёркнутый текст (~~текст~~). Стандарт GFM ввёл эти элементы, сделав разметку полноценным инструментом для технической документации.
По классическому стандарту Markdown для создания тега <br> нужно поставить ровно два пробела в конце строки перед нажатием Enter. Также допускается прямое использование HTML-тега <br>.
Используйте двоеточия в строке разделителя: :--- для выравнивания по левому краю, :---: для центрирования и ---: для выравнивания чисел по правому краю таблицы.
Да, парсеры Markdown корректно обрабатывают встроенные HTML-теги (например, <details>, <span>, <table>, <img>), если стандартных возможностей синтаксиса разметки недостаточно для реализации макета.
Воспользуйтесь «Конвертером Markdown в HTML» на Utilora: вставьте разметку в редактор, и утилита мгновенно сгенерирует валидный HTML-код с синхронным окном визуального предпросмотра.