Заголовок

Нотация Markdown поддерживает несколько стилей оформления заголовков: Atx, Setext, смешанные нотации.

Стиль оформления Atx

Правила разметки:

Заголовки в стиле Atx используют от 1 до 6 символов "решётка" (#) в начале строки. Каждый символ означает один уровень заголовка.
Разметка заголовка должна начинаться от начала строки, без пробелов и других символов.
После символов "решётка" (#) требуется поставить пробел.
Перед и после заголовка требуется пустая строка.

Примеры разметки заголовков:

# Заголовок первого уровня.

## Заголовок второго уровня.

### Заголовок третьего уровня.

#### Заголовок четвёртого уровня.

##### Заголовок пятого уровня.

###### Заголовок шестого уровня.

При публикации размеченный текст даст следующий HTML код:

<h1>Заголовок первого уровня.</h1>

<h2>Заголовок второго уровня.</h2>

<h3>Заголовок третьего уровня.</h3>

<h4>Заголовок четвёртого уровня.</h4>

<h5>Заголовок пятого уровня.</h5>

<h6>Заголовок шестого уровня.</h6>

Стиль оформления Setext

Стиль оформления Setext используется для простых по структуре текстов, в которых достаточно двух уровней:

основного заголовка;
подзаголовка.

Для разметки основного заголовка требуется поставить не менее трёх знаков равенства (=) подряд. Пример разметки основного заголовка:

Основной заголовок

==================

или

Основной заголовок

==========

или

Основной заголовок

===

При публикации размеченный текст даст следующий HTML код:

<h1>Основной заголовок</h1>

Для разметки подзаголовка требуется поставить не менее трёх дефисов (-) подряд. Пример разметки вспомогательного заголовка:

Подзаголовок

-------------------------

или

Подзаголовок

----------

или

Подзаголовок

---

При публикации размеченный текст даст следующий HTML код:

<h2>Подзаголовок</h2>

Идентификатор заголовка

В разметке заголовка применяют идентификатор (якорь, привязочную ссылку) в следующих случаях:

если в тексте необходимо вставить гиперссылку на заголовок;
если необходимо изменить оформление заголовка с помощью стилей CSS.

Некоторые процессоры Markdown автоматически добавляют идентификатор заголовка. Если автоматической возможности нет, идентификатор следует вставить вручную.

Идентификатор заголовка представляет собой строку знаков:

первым символом которой служит знак решётка (#), ;
заключённую в фигурные скобки;
расположенную после наименования заголовка.

Пример идентификатора заголовка:

### Наименование заголовка {#custom-id}

HTML код идентификатора заголовка:

<h3 id="custom-id">Наименование заголовка</h3>

Пример заголовка с идентификатором и ссылкой:

### [Наименование заголовка](#custom-id)

HTML код заголовка с идентификатором и ссылкой:

<h2 id="наименование-заголовка"><a href="#custom-id">Наименование заголовка</a></h2>

Ссылка на заголовок

Если в заголовке указан идентификатор, то на подобный заголовок в тексте можно устанавливать ссылки.

Пример ссылки на заголовок:

## [Наименование заголовка](#custom-id)

При публикации размеченный текст даст следующий HTML код:

<h2 id="наименование-заголовка"><a href="#custom-id">Наименование заголовка</a></h2>

Ссылка на заголовок в браузере выглядит следующим образом:

https://www.expample.site/pageName#custom-id

Google Sites

Report abuse