Инструкция по разметке Markdown

Markdown — лёгкий язык разметки текста. Он позволяет форматировать документы (заголовки, списки, ссылки, таблицы и т.д.), используя простые текстовые символы, без HTML-тегов.

Заголовки создаются символом # в начале строки. Количество решёток определяет уровень заголовка (от 1 до 6).

# Заголовок 1 уровня
## Заголовок 2 уровня
### Заголовок 3 уровня
#### Заголовок 4 уровня
##### Заголовок 5 уровня
###### Заголовок 6 уровня

Альтернативный способ для заголовков 1 и 2 уровня:

Заголовок 1
===========

Заголовок 2
-----------
Результат Синтаксис
Жирный **текст** или __текст__
Курсив *текст* или _текст_
Жирный курсив ***текст***
Зачёркнутый ~~текст~~ (GFM)
Моноширинный (код) ` `текст` `
- Пункт 1
- Пункт 2
  - Вложенный пункт
- Пункт 3

Также допустимы символы * и + вместо -.

1. Первый пункт
2. Второй пункт
3. Третий пункт
- [x] Сделано
- [ ] Не сделано
[Текст ссылки](https://example.com)
[Ссылка с подсказкой](https://example.com "Подсказка при наведении")
<https://example.com>

Ссылки со сносками (reference-style):

[Текст ссылки][1]

[1]: https://example.com
![Альтернативный текст](https://example.com/image.png)
![Альтернативный текст](https://example.com/image.png "Подсказка")
Используйте функцию `print()` для вывода.

Через отступ в 4 пробела либо через ограждение из обратных кавычек:

```python
def hello():
    print("Привет, мир!")
```

Указание языка после первых трёх кавычек включает подсветку синтаксиса.

> Это цитата.
> Она может занимать несколько строк.
>
> > Вложенная цитата.

Три и более символа -, * или _ на отдельной строке:

---
***
___
| Столбец 1 | Столбец 2 | Столбец 3 |
|-----------|:---------:|----------:|
| Слева     | По центру | Справа    |
| текст     | текст     | текст     |

Двоеточия в разделительной строке задают выравнивание: слева, по центру, справа.

Чтобы отобразить служебный символ буквально, поставьте перед ним обратный слэш:

\*не курсив\*
\# не заголовок

Экранировать можно: \ ` * _ { } [ ] ( ) # + - . !

Текст со сноской[^1].

[^1]: Текст самой сноски.
<https://example.com>
<mail@example.com>

Чтобы перенести строку внутри абзаца без начала нового абзаца, поставьте два пробела в конце строки либо используйте <br>.

  • Между блоками (заголовками, списками, абзацами) обычно нужна пустая строка, иначе разметка может не сработать.
  • Разные движки Markdown (GitHub, GitLab, обычный CommonMark и т.д.) могут по-разному поддерживать таблицы, зачёркивание, списки задач и сноски — это расширения, а не часть исходной спецификации.
  • Для проверки разметки удобно использовать онлайн-редакторы, например Dillinger или StackEdit.