---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/syntax/notes.md
  - https://3y3.dev/ru/syntax/notes.md
  - href: ru/syntax/notes.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-06-08T16:57:28.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Заметки

Заметка — это выделяющийся блок с важной информацией.

В зависимости от содержания используют заметки с различными заголовками и оформлением:
* [«Примечание»](#info) — дополнительная информация.
* [«Совет»](#tip) — рекомендация.
* [«Важно»](#warning) — предостережение.
* [«Внимание»](#alert) — ограничение.
* Заметка со своим заголовком.

Заметки могут включать любую разметку YFM, но не рекомендуется перегружать их элементами. Выбирайте простое оформление и не используйте заметки слишком часто, так как это будет отвлекать пользователя от основного содержимого.

<!-- source: ru/_includes/blank-lines-note.md -->
{% note warning %}

Конструкция работает, только если отделена пустыми строками — снаружи (до открывающего и после закрывающего тега) и внутри (между тегами и содержимым). Иначе она не обработается и останется обычным текстом.

{% endnote %}
<!-- endsource: ru/_includes/blank-lines-note.md -->

## Примечание {#info}

```markdown
{% note info %}

Это примечание.

{% endnote %}
```

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

{% note info %}

Это примечание.

{% endnote %}

## Совет {#tip}
  
```markdown
{% note tip %}

Это совет.

{% endnote %}
```

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

{% note tip %}

Это совет.

{% endnote %}

## Важно {#warning}

```markdown
{% note warning %}

Это важная информация.

{% endnote %}
```

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

{% note warning %}

Это важная информация.

{% endnote %}
  
## Внимание {#alert}

```markdown
{% note alert %}

Это предупреждение.

{% endnote %}
```

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

{% note alert %}

Это предупреждение.

{% endnote %}

## Свой заголовок {#title}

```markdown
{% note info "Свой заголовок" %}

Это заметка со своим заголовком.

{% endnote %}
```

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

{% note info "Свой заголовок" %}

Это заметка со своим заголовком.

{% endnote %}

```markdown
{% note info "" %}

Это заметка без заголовка.

{% endnote %}
```

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

{% note info "" %}

Это заметка без заголовка.

{% endnote %}