Содержание

Инструкция по разметке 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. Изображения

![Альтернативный текст](https://example.com/image.png)
![Альтернативный текст](https://example.com/image.png "Подсказка")

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. Полезно знать