Шпаргалка по Markdown: справочник синтаксиса с примерами

В этом справочнике перечислен каждый распространённый элемент Markdown с простым однострочным объяснением и коротким примером в блоке кода для копирования.

Заголовки, абзацы и разрывы строк

Заголовки используют от одного до шести символов #, за которыми следует пробел; меньше # означает более крупный заголовок. Пустая строка начинает новый абзац. Чтобы принудительно вставить разрыв строки внутри абзаца, завершите строку двумя пробелами или обратной косой чертой.

# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.

Выделение, ссылки и изображения

Звёздочки или подчёркивания отмечают курсив и полужирный текст, а их сочетание даёт оба эффекта. Ссылки используют квадратные скобки для текста и круглые скобки для URL; изображения используют тот же синтаксис с ведущим !.

*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](/path/to/image.png)

Списки и вложенные списки

Маркированные списки используют -, * или +. Нумерованные списки используют числа с точкой. Используйте отступ в два или четыре пробела для вложения одного списка в другой.

- item one
- item two
  - nested item
1. first
2. second

Таблицы

GitHub Flavored Markdown добавляет таблицы с вертикальными чертами. Строка из дефисов под строкой заголовка задаёт структуру столбцов и может задавать выравнивание.

| Name | Type |
| --- | --- |
| Alpha | text |
| Beta | number |

Код, цитаты и горизонтальные линии

Обратные апострофы отмечают встроенный код, а тройные обратные апострофы открывают блок кода, опционально помеченный языком для подсветки синтаксиса. Символ > в начале строки отмечает цитату; складывайте несколько > для вложенных цитат. Три дефиса, звёздочки или подчёркивания сами по себе на строке рисуют горизонтальную линию.

Use `git status` to check the working tree.

print("hello")

> A quoted sentence.
>> A nested quote.

---

Списки задач и экранирование

GitHub Flavored Markdown поддерживает флажки внутри элементов списка. Обратная косая черта перед специальным символом печатает его буквально, а не запускает форматирование. Необработанные теги HTML также разрешены внутри строки в большинстве обработчиков, хотя эта шпаргалка придерживается простого синтаксиса Markdown.

- [x] done
- [ ] not done

Escaped: \* not italic \*

GitHub Flavored Markdown в сравнении с CommonMark

CommonMark определяет базовые правила: заголовки, выделение, списки, ссылки, блоки кода и цитаты. GitHub Flavored Markdown строится на основе CommonMark и добавляет таблицы, списки задач, зачёркнутый текст и автоматическое превращение обычных URL в ссылки. Файл, написанный для одного, как правило, нормально отображается в другом, но таблицы и флажки требуют именно поддержки GitHub Flavored Markdown.

Расширенный синтаксис: математика, примечания, front matter и диаграммы

Поддержка этих расширений зависит от обработчика, поэтому проверьте целевой инструмент, прежде чем на них рассчитывать. Математика использует разделители в стиле LaTeX, примечания используют символ «крышка» и метку, front matter, это блок метаданных в начале файла, а диаграммы используют помеченный блок кода.

Inline math: $a^2 + b^2 = c^2$
Block math: $$E = mc^2$$

Text with a note.[^1]
[^1]: The note itself.

---
title: Example document
date: 2026-01-01
---

graph TD
  A --> B
  B --> C

Собираем всё вместе

Пишите и просматривайте документ в Редакторе Markdown, проверяйте проблемы синтаксиса с помощью Markdown Lint и создавайте содержание с помощью Markdown TOC. Когда вам нужен файл для обмена, экспортируйте с помощью Markdown в PDF или Markdown в Word. Чтобы подробнее узнать о преобразовании PDF обратно в Markdown, смотрите руководство по PDF в Markdown.