# Форматирование сообщений в Telegram

## Разметка Markdown

Чтобы правильно разметить текст в нужном блоке (разметка находится под полем ввода текста сообщения), строго следуйте следующим шагам:

<div data-with-frame="true"><figure><img src="/files/2c1acc2f088409c701c075a995a185becee361ac" alt="" width="563"><figcaption></figcaption></figure></div>

1. Поместите нужный текст в поле ответа.

Если вы используете в тексте переменные, вы <mark style="color:красный;">**не должны**</mark> указывать их на этом этапе. Иначе синтаксис переменной будет нарушен, символы #{} также будут экранированы, и переменная не появится в тексте.

2. Включаем "Markdown в Telegram". Так в ваш текст будут добавлены символы экранирования.
3. Выбираем текст \*\* или \_ \_, и т. д.

{% hint style="danger" %}
если в этом блоке встречаются любые из следующих символов: '\_', '\*', '\[', ']', '(', ')', '\~', '\`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' — их нужно экранировать, добавив перед ними обратную косую черту \\\\&#x20;

Иначе сообщение вообще не будет отправлено. Неважно, какую именно часть текста вы разметите.

Пример: hi\\. Рад видеть \*тебя\* \\!
{% endhint %}

Специальные символы:

**Жирный текст** — поставьте звёздочки с обеих сторон: \* вот текст\*\
**Курсив** — подчёркивание:  \_текс&#x442;*\_*\
**Подчёркнутый текст** — два нижних подчёркивания с обеих сторон: \_\_текст\_\_\
**Зачёркнутый текст -** — это тильда с обеих сторон текста: \~text\~\
Ссылка в тексте: \[текст в квадратных скобках]\(ссылка в скобках):\
\[встроенный URL] ([http://www.example.com/](https://vk.com/away.php?to=http%3A%2F%2Fwww.example.com%2F\&cc_key=)) \
**Упоминание пользователя Telegram:** \[текст в квадратных скобках] (ссылка на пользователя в скобках). После знака равенства в ссылке можно использовать #{platform\_id}.\
\[встроенное упоминание пользователя]\(tg://user?id=123456789)\
**Текст в виде кода** — поставьте обратную кавычку с обеих сторон текста: `встроенный фиксированной ширины код`\
**Скрытый текст или спойлер** - используйте || с обеих сторон текста

4. Далее размечаем нужный текст с помощью специальных символов.

**Пример:**

<div data-with-frame="true"><figure><img src="/files/77f7a28f7eed13dda52d0914ce43ebdda03324ff" alt="" width="563"><figcaption><p>Пример разметки</p></figcaption></figure></div>

Результат:

<div data-with-frame="true"><figure><img src="/files/283f70c8ced9452cc7f108076ffc0d8de17558b0" alt="" width="425"><figcaption></figcaption></figure></div>

При работе с Markdown необходимо не забывать, что специальные символы нужно экранировать, а управляющие символы в тексте — заменять соответствующими текстовыми подстановками. Это делается довольно просто, добавив **обратную косую черту \\\\** перед специальным символом или используя функцию Calculator.

**txt = tg\_escape(s), где** **s** - строка исходного текста&#x20;

{% hint style="info" %}
Чтобы присвоить переменной многострочное текстовое значение, укажите его следующим образом:

`your_variable = "Текст первой строки" + "\n" + "Текст второй строки" + "\n" +"Текст третьей строки"`
{% endhint %}

Вывод в **txt** файле — это строка, в которой слэши уже вставлены в нужных местах.

**Пример:**

<figure><img src="/files/9fc3a48ec5c55840e9f0189e6783ae263d9a900c" alt=""><figcaption><p>Пример экранирования</p></figcaption></figure>

<div data-with-frame="true"><figure><img src="/files/ea4d3ed1dd70d3928456229ce2ad0d53108a2f47" alt=""><figcaption><p>Как выглядит текст Telegram</p></figcaption></figure></div>

Далее разметьте нужный текст.

#### Пример с длинным текстом:

<div data-with-frame="true"><figure><img src="/files/7072e86d40596a7b0b3d66cb8a9a3014b5adbdff" alt="" width="364"><figcaption></figcaption></figure></div>

Для этого нужно использовать калькулятор:

Шаг 1. Вставьте текст в поле сообщения:

<div data-with-frame="true"><figure><img src="/files/2b8a87e7b95594fe9486b84b2896de838f355246" alt="" width="375"><figcaption></figcaption></figure></div>

Шаг 2. Включите кнопку разметки Markdown:

<div data-with-frame="true"><figure><img src="/files/00ecccce72d6b0e9983ffae09392fc2bec5a7efb" alt="" width="375"><figcaption><p>После включения кнопки разметки специальные символы экранируются.</p></figcaption></figure></div>

Шаг 3. Расставляем в тексте специальные символы для форматирования сообщения:

<div data-with-frame="true"><figure><img src="/files/031d4a5540ccf0a395026a0e009d48026b6f5310" alt="" width="375"><figcaption></figcaption></figure></div>

Если после отправки сообщение не дошло до мессенджера, а в диалоге в разделе Clients вы видите ошибку, значит, вы неправильно экранировали символы..&#x20;

При этом при отправке сообщения в разделе "Clients" вы увидите ошибку — в ней будет символ, который не был экранирован.

Сообщения об ошибках, которые вы можете увидеть:

1. Отсутствует закрывающий символ:

<div data-with-frame="true"><figure><img src="/files/9c41f4c5fa51293c199c68cc3356cf2aad10f5a3" alt="" width="188"><figcaption></figcaption></figure></div>

<div data-full-width="true" data-with-frame="true"><figure><img src="/files/847c5ef018cdc87c55fe40a3a76b0bdeec5b536b" alt="" width="188"><figcaption></figcaption></figure></div>

2. Отсутствует экранирование символа:

<div data-with-frame="true"><figure><img src="/files/c1e847f6bb68a25ead293ace647f7fe94777d8cd" alt="" width="188"><figcaption></figcaption></figure></div>

## &#x20;HTML-разметка

Чтобы HTML-разметка заработала, не забудьте нажать кнопку HTML под полем текста сообщения:

<div data-with-frame="true"><figure><img src="/files/e2d90b62bd514fc3adf808d8263ecdf4a96efcb4" alt="" width="563"><figcaption></figcaption></figure></div>

1. \<a href="[https://google.com">ссылка\\](https://docs.mavibot.ai/doc/ru/chatbot/messendzhery/telegram/https:/google.com">ссылка\\)</a> - встраивает ссылку в одно слово.

Пример заполнения:

<div data-with-frame="true"><figure><img src="/files/710956b348130a9c28dbba83911ee0ff068f154f" alt="" width="563"><figcaption></figcaption></figure></div>

2. \<u>подчёркнутый\</u> - подчёркнутый шрифт

Пример:

<div data-with-frame="true"><figure><img src="/files/e220fc4c8c87b46de7fffcb256c91336255369a1" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d48df23efcf08df0b5496411d4ef3f53a26948b5" alt="" width="563"><figcaption></figcaption></figure></div>

3. \<ins>подчёркнутый\</ins> - подчёркнутый шрифт

Пример:

<div data-with-frame="true"><figure><img src="/files/40eaf6edb0250f4edcf16e9719d2b09a50f364a6" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/96cd424e2c4a8135ac0cc9e63785dd0133b25fd6" alt="" width="563"><figcaption></figcaption></figure></div>

4. \<em>курсив\</em> - курсивный шрифт

Пример:

<div data-with-frame="true"><figure><img src="/files/5479636889d9f0a8df09f6d7145069b63b6d182a" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/a67ea8cfa583eb9d828ad8a989941b0fe023d3d7" alt="" width="563"><figcaption></figcaption></figure></div>

5. \<i>курсив\</i> - курсивный шрифт

Пример:

<div data-with-frame="true"><figure><img src="/files/c882c07b431750e748feb05d286206a6b7316b39" alt="" width="563"><figcaption></figcaption></figure></div>

\<strong>жирный\</strong> - жирный шрифт

<div data-with-frame="true"><figure><img src="/files/c49b506eaa81ffba87145c97ae598963065dbebe" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/4fc153a92fec2e5dfd4cf51e87b0da17ebfa80f3" alt="" width="563"><figcaption></figcaption></figure></div>

\<strike>strike\</strike> - зачёркнутый текст

<div data-with-frame="true"><figure><img src="/files/c12de5a531a5ad05e134a819850be471cda1890a" alt="" width="563"><figcaption></figcaption></figure></div>

\<span class="tg-spoiler">hidden\</span> - скрытый текст

Пример:

<div data-with-frame="true"><figure><img src="/files/19e4031bd7597ebaa0f241233cdae395adfddef2" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5a90d8b44e2c5f74888c4c44cfbb79cd9885db5f" alt="" width="563"><figcaption></figcaption></figure></div>

\<code>Prerfomatted\</code> - форматированный текст

Пример:

<div data-with-frame="true"><figure><img src="/files/64beb4dbc7411c43bb94884387244e89312ab4cc" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/36d6083598de570f7c74b1848c5af62a390cd4d1" alt="" width="563"><figcaption></figcaption></figure></div>

\<pre>Предварительно отформатированный\</pre> - форматированный шрифт

Пример:

<div data-with-frame="true"><figure><img src="/files/931332908521bee5d2fae761f8f04eb2838e30f2" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5f3b7f9007ac68eedbd73ff3fc5224bb01b2216a" alt="" width="526"><figcaption></figcaption></figure></div>

## Как включить защищённый режим для контента

Чтобы защитить контент от пересылки, вы можете включить защищённый режим для сообщений. Для этого перейдите в раздел «Сообщение» и включите «Защитить контент":

<div data-with-frame="true"><figure><img src="/files/c8be18305de144a0fb06b3bc217e2dcbd9dc2b21" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Защищённые сообщения нельзя пересылать, а также нельзя сделать скриншот на телефоне.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/chatbot/messendzhery/telegram/formatting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.