---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/syntax/base.md
  - https://3y3.dev/ru/syntax/base.md
  - href: ru/syntax/base.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-07-23T07:10:07.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Базовая разметка

## Строчное форматирование {#line}

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

Разметка | Результат
----- | -----
`**Полужирный текст**` | **Полужирный текст**
`_Курсив_` | _Курсив_
`**_Полужирный курсив_**` | **_Полужирный курсив_** 
`_**Тоже полужирный курсив**_` | _**Тоже полужирный курсив**_
`~~Зачеркнутый текст~~` | ~~Зачеркнутый текст~~
`Верхний^регистр^` | Верхний^регистр^
`##Моноширинный текст##` | ##Моноширинный текст##
`{red}(Цветной текст)` | {red}(Цветной текст)

Для использования нижнего регистра или подчеркнутого текста необходимо подключить дополнительные плагины. Подробнее в разделе [Дополнительные возможности](https://3y3.dev/ru/syntax/additional.md).

## Параграфы {#sections}

Для создания параграфа отделите пустой строкой один блок текста от другого.

```markdown
Параграф.

Следующий параграф.
```

**Результат:**

Параграф.

Следующий параграф.

## Переносы строк {#breaks}

Для переноса строки перенесите каретку.
```markdown
Строка.
Следующая строка.
```

**Результат:**

Строка.
Следующая строка.

Чтобы вместо переноса каретки использовать два пробела в конце строки, в [настройках](https://3y3.dev/ru/settings.md) задайте значение `breaks: false`. 

## Заголовки {#headers}

Выделяют следующие уровни заголовков:
* первый уровень (h1) для заголовка страницы;
* второй (h2), третий (h3), четвертый (h4) и т.д. уровни для заголовков подразделов.

```markdown
# Заголовок h1
## Заголовок h2
### Заголовок h3
#### Заголовок h4
```

Во время сборки для каждого заголовка формируется якорь. Якоря позволяют создавать [ссылки](https://3y3.dev/ru/syntax/links.md), ведущие на разделы документа.

По умолчанию якорь в YFM — это текст заголовка, записанный в латинской транслитерации. Вы можете задать якорь вручную, указав его после заголовка:

```markdown
## Заголовок h2 {#anchor-example}
```

Чтобы одновременно с якорями в стиле YFM также генерировались якоря по правилам GitHub, в [настройках](https://3y3.dev/ru/settings.md) задайте значение `supportGithubAnchors: true`.

{% note warning %}

Заголовки первого уровня используются только как заголовки страницы.
У них есть ограничения: они не работают с якорями и не отображаются в _оглавлении страницы_.

{% endnote %}


## Цитаты {#quotes}

Для отображения цитаты используйте следующую разметку:

```markdown
> Цитирование
```

**Результат:**

> Цитирование

```markdown
> Цитирование
>> Вложенное цитирование
```

**Результат:**

> Цитирование
>> Вложенное цитирование

## Экранирование {#escaping}

Чтобы служебный символ разметки не был интерпретирован, экранируйте его с помощью символа `\`.

```markdown
Верхний^регистр^
Верхний\^регистр^
```
**Результат:**

Верхний^регистр^
Верхний\^регистр^

## Комментарии {#comments}

Комментарии — элементы разметки, которые не отображаются в собранном файле. Они используются, чтобы хранить в исходном тексте информацию для SEO или авторов документа.

Чтобы добавить комментарий, используйте следующую разметку. Убедитесь, что до комментария есть пустая строка.

```markdown
[//]: # (Комментарий)
```

## Использование HTML {#html}

По умолчанию YFM экранирует HTML. Чтобы отключить экранирование, в [настройках](https://3y3.dev/ru/settings.md) задайте значение `allowHtml: true`.