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

Заголовки

# Заголовок H1
## Раздел H2
### Подраздел H3

Используйте стиль ATX (#), а не Setext (=== под текстом). Все парсеры поддерживают оба варианта, но ATX легче читается в diff.

Выделение

*курсив* или _курсив_, **жирный** или __жирный__, ***жирный курсив***. GFM добавляет ~~зачёркивание~~.

Списки

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

- Первый
- Второй
  - Вложенный (два пробела)

Упорядоченные списки нумеруются автоматически:

1. Элемент
1. Элемент
1. Элемент

Код

Встроенный: `code`. Огороженные блоки с необязательным языковым тегом:

```python
def hello(name):
    return f"Привет, {name}"
```

Если вам ближе старый синтаксис, сделайте для блока кода отступ в четыре пробела.

Ссылки и изображения

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

Ссылочный стиль позволяет вынести длинные URL за пределы абзаца:

См. [документацию][1].

[1]: https://example.com/docs

Таблицы (GFM)

| Col A | Col B |
|-------|------:|
| a     |     1 |
| b     |    22 |

Выравнивание задаётся двоеточиями в строке-разделителе: :---, по левому краю, :---:, по центру, ---:, по правому краю.

Списки задач (GFM)

- [x] Готово
- [ ] Сделать

Частые ошибки

• Два пробела в конце строки вставляют перенос строки внутри абзаца. Один пробел лишь соединяет строки.
• Перед большинством блочных элементов (заголовками, списками, блоками кода) нужна пустая строка.
• Не делайте отступ у маркеров списка табуляцией, если ваш рендерер ожидает пробелы; используйте два или четыре пробела.
• Экранируйте обратной косой чертой, чтобы показать знак препинания буквально: \*не курсив\*.
• Умные кавычки различаются в зависимости от рендерера. GitHub оставляет их как есть, а Pandoc преобразует.