Ответ
В Markdown заголовки обозначаются символом `#` (решётка) в начале строки. Количество символов определяет уровень заголовка (от 1 до 6). Также для первых двух уровней существует альтернативный синтаксис с подчёркиванием.
**Основной синтаксис (используя #):**
```markdown
# Заголовок 1 уровня
## Заголовок 2 уровня
### Заголовок 3 уровня
#### Заголовок 4 уровня
##### Заголовок 5 уровня
###### Заголовок 6 уровня
```
**Альтернативный синтаксис (только для H1 и H2):**
```markdown
Заголовок 1 уровня
==================
Заголовок 2 уровня
------------------
```
**Практические рекомендации:**
* Между символом `#` и текстом рекомендуется ставить пробел (хотя некоторые парсеры обработают и без него).
* Заголовки структурируют документ и используются для автоматического создания оглавления.
* В HTML это преобразуется в теги `` – `
` – ``.
Ответ 18+ 🔞
Ну вот, сидишь ты, пишешь свою документацию, и тут — бац! — нужно заголовок вставить. А как, блядь, его оформить? Я тебе сейчас всё разжую, как будто для полного дебила, потому что сам когда-то нихуя не понимал.
Смотри, вся магия в этой решётке `#`. Одна решётка — и ты царь и бог, заголовок первого уровня, самый главный, жирный и большой. Это как крикнуть: «СЛУШАЙТЕ ВСЕ, СУКА!». Две решётки `##` — уже потише, но всё ещё важно. И так далее, вплоть до шести. Шесть решёток — это уже такой шёпот на ушко, который почти не видно.
```markdown
# Я — БОСС (H1)
## Я — поменьше, но тоже важный (H2)
### Ну я так, раздел (H3)
#### Совсем мелко (H4)
##### Почти невидимка (H5)
###### А я? А меня кто-нибудь видит? (H6)
```
Альтернативный вариант — для тех, кто любит постаромоднее, как будто на дворе 2002-й год. Под H1 черту жирную, под H2 — тонкую. Но это, честно говоря, **доверия ебать ноль** — легко запутаться, где что кончилось. Лучше уж решётки.
**Важные моменты, а то опять накосячишь:**
* Между решёткой и текстом **поставь пробел**, ёпта! Без него некоторые тупые парсеры могут обосраться и не понять твои гениальные мысли. `#Заголовок` — плохо. `# Заголовок` — вот это по-взрослому.
* Это не просто жирный текст, чувак. Из этого автоматически оглавления строятся, навигация. Пизда рулю, если ты ими не пользуешься.
* А внутри, в итоге, это превращается в обычные HTML-теги ``, `
