Шпаргалка по Markdown

Markdown – это простой способ форматировать текст, который отлично выглядит на любом устройстве. Он не делает ничего сложного вроде смены размера, цвета или начертания шрифта – только самое необходимое, с помощью символов на клавиатуре, которые вы уже знаете. Это полный справочник: каждое правило показано рядом с готовым результатом.

Заголовки

Ставьте символы # перед текстом – одна # для самого крупного заголовка, до шести для самого мелкого. Два верхних уровня также имеют стиль с «подчёркиванием».

Markdown	Результат
`# Заголовок 1 Заголовок 1 =========`	Заголовок 1
`## Заголовок 2 Заголовок 2 ---------`	Заголовок 2
`### Заголовок 3`	Заголовок 3
`#### Заголовок 4`	Заголовок 4
`##### Заголовок 5`	Заголовок 5
`###### Заголовок 6`	Заголовок 6

Выделение

Оберните текст в символы, чтобы сделать его полужирным, курсивным или ~~зачёркнутым~~. Звёздочки и подчёркивания работают одинаково.

Markdown	Результат
`Курсив _Курсив_`	Курсив
`Полужирный __Полужирный__`	Полужирный
`*Полужирный & курсив*`	*Полужирный & курсив*
`~~Зачёркнутый~~`	~~Зачёркнутый~~

Цитаты

Начните строку с >, чтобы процитировать текст. Добавьте ещё один > для вложенных цитат и пустые строки > для разделения абзацев.

Markdown	Результат
`> Это цитата.`	Это цитата.
`> Первый абзац. > > Второй абзац.`	Первый абзац. Второй абзац.
`> Уровень один >> Уровень два`	Уровень один Уровень два

Списки

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

Markdown	Результат
`- Первый пункт - Второй пункт - Третий пункт`	Первый пункт Второй пункт Третий пункт
`1. Первый пункт 2. Второй пункт 3. Третий пункт`	Первый пункт Второй пункт Третий пункт
`1. Первый пункт - Подпункт - Подпункт 2. Второй пункт`	Первый пункт Подпункт Подпункт Второй пункт

Списки задач

Добавьте [ ] для пустого флажка или [x] для отмеченного сразу после маркера. Отлично подходит для списков дел на GitHub.

Markdown	Результат
`- [x] Изучить Markdown - [ ] Освоить Markdown - [ ] Научить друга`	Изучить Markdown Освоить Markdown Научить друга

Ссылки

Поместите видимый текст в [ ], а адрес в ( ). Ссылки-сноски хранят адрес внизу, а голые URL становятся ссылками автоматически.

Markdown	Результат
`[Markdown69](https://markdown69.com)`	Markdown69
`[Наведи на меня](https://markdown69.com "Лучшая шпаргалка")`	Наведи на меня
`[Ссылка-сноска][site] [site]: https://markdown69.com`	Ссылка-сноска
`<https://markdown69.com>`	https://markdown69.com
`[Наверх](#top)`	Наверх

Изображения

То же, что и ссылки, но с ! впереди. Текст в [ ] становится альтернативным текстом, который показывается, когда изображение не загружается.

Markdown	Результат
`![Логотип Markdown](/img/markdown.png)`
`![Логотип](/img/markdown.png "Markdown")`
`[![Кликабельно](/img/markdown.png)](https://markdown69.com)`

Код

Оборачивайте строчный код в одинарные обратные кавычки. Для целого блока используйте три обратные кавычки (по желанию указав язык) или отступ в четыре пробела на каждой строке.

Markdown	Результат
Используйте функцию `print()`.	Используйте функцию `print()`.
``` простой блок кода ```	`простой блок кода`
```python def hello(): print("Hi!") ```	`def hello(): print("Hi!")`

Таблицы

Разделяйте столбцы вертикальными чертами |, а заголовок от тела – дефисами -. Добавьте двоеточия : в строке-разделителе, чтобы выровнять столбец по левому краю, центру или правому краю.

Markdown Результат

| Синтаксис | Описание |
| ------ | ----------- |
| Заголовок | Название |
| Ячейка | Текст |

Синтаксис	Описание
Заголовок	Название
Ячейка	Текст

| Слева | Центр | Справа |
| :--- | :----: | ----: |
| a | b | c |

Слева	Центр	Справа
a	b	c

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

Три или более дефиса, звёздочки или подчёркивания на отдельной строке рисуют разделитель.

Markdown	Результат
`--- *** ___`

Переносы строк

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

Markdown Результат

Первая строка··
Вторая строка

Первая строка
Вторая строка

Новый абзац

после пустой строки

Новый абзац

после пустой строки

Экранирование символов

Поставьте обратную косую черту \ перед символом, чтобы показать его буквально, а не форматировать текст.

Markdown	Результат
`\Не курсив\`	Не курсив
`1\. Не список`	1. Не список

Сноски

Отметьте место с помощью [^1] и напишите примечание где угодно на отдельной строке. Читатель переходит между ними по клику.

Markdown	Результат
`Вот примечание.[^1] [^1]: Текст сноски.`	Вот примечание.¹ Текст сноски. ↩

Эмодзи

Многие редакторы (GitHub, Slack, Discord) превращают :shortcodes: в эмодзи. Также можно вставить символ эмодзи напрямую.

Markdown	Результат
`:tada: Выпустили! :rocket:`	🎉 Выпустили! 🚀
`Выглядит хорошо :+1:`	Выглядит хорошо 👍

Встроенный HTML

Когда возможностей Markdown не хватает, вставьте чистый HTML, и он отобразится как есть.

Markdown	Результат
`Текст с <sub>нижним индексом</sub> и <sup>верхним индексом</sup>.`	Текст с _{нижним индексом} и ^{верхним индексом}.
`<kbd>Ctrl</kbd> + <kbd>C</kbd>`	`Ctrl` + `C`

Встраивание видео

Markdown не может встроить видеоплеер, но вы можете сделать миниатюру ссылкой на видео. Клик по изображению открывает видео.

Markdown	Результат
`[![Смотреть видео](/img/markdown.png)](https://youtu.be/VIDEO_ID)`

Онлайн-редактор Markdown с живым предпросмотром