Инструкция по разметке Markdown
Markdown — лёгкий язык разметки текста. Он позволяет форматировать документы (заголовки, списки, ссылки, таблицы и т.д.), используя простые текстовые символы, без HTML-тегов.
1. Заголовки
Заголовки создаются символом # в начале строки. Количество решёток определяет уровень заголовка (от 1 до 6).
# Заголовок 1 уровня ## Заголовок 2 уровня ### Заголовок 3 уровня #### Заголовок 4 уровня ##### Заголовок 5 уровня ###### Заголовок 6 уровня
Альтернативный способ для заголовков 1 и 2 уровня:
Заголовок 1 =========== Заголовок 2 -----------
2. Начертание текста
| Результат | Синтаксис |
|---|---|
| Жирный | **текст** или __текст__ |
| Курсив | *текст* или _текст_ |
| Жирный курсив | ***текст*** |
| | ~~текст~~ (GFM) |
| Моноширинный (код) | ` `текст` ` |
3. Списки
Маркированный список
- Пункт 1 - Пункт 2 - Вложенный пункт - Пункт 3
Также допустимы символы * и + вместо -.
Нумерованный список
1. Первый пункт 2. Второй пункт 3. Третий пункт
Список задач (task list, GFM)
- [x] Сделано - [ ] Не сделано
4. Ссылки
[Текст ссылки](https://example.com) [Ссылка с подсказкой](https://example.com "Подсказка при наведении") <https://example.com>
Ссылки со сносками (reference-style):
[Текст ссылки][1] [1]: https://example.com
5. Изображения
 
6. Код
Строчный код
Используйте функцию `print()` для вывода.
Блок кода
Через отступ в 4 пробела либо через ограждение из обратных кавычек:
```python
def hello():
print("Привет, мир!")
```
Указание языка после первых трёх кавычек включает подсветку синтаксиса.
7. Цитаты
> Это цитата. > Она может занимать несколько строк. > > > Вложенная цитата.
8. Горизонтальная линия
Три и более символа -, * или _ на отдельной строке:
--- *** ___
9. Таблицы (GFM)
| Столбец 1 | Столбец 2 | Столбец 3 | |-----------|:---------:|----------:| | Слева | По центру | Справа | | текст | текст | текст |
Двоеточия в разделительной строке задают выравнивание: слева, по центру, справа.
10. Экранирование символов
Чтобы отобразить служебный символ буквально, поставьте перед ним обратный слэш:
\*не курсив\* \# не заголовок
Экранировать можно: \ ` * _ { } [ ] ( ) # + - . !
11. Сноски (footnotes, расширение)
Текст со сноской[^1]. [^1]: Текст самой сноски.
12. Автоматические ссылки и почта
<https://example.com> <mail@example.com>
13. Разрыв строки
Чтобы перенести строку внутри абзаца без начала нового абзаца, поставьте два пробела в конце строки либо используйте <br>.
14. Полезно знать
- Между блоками (заголовками, списками, абзацами) обычно нужна пустая строка, иначе разметка может не сработать.
- Разные движки Markdown (GitHub, GitLab, обычный CommonMark и т.д.) могут по-разному поддерживать таблицы, зачёркивание, списки задач и сноски — это расширения, а не часть исходной спецификации.