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

### Разметка Markdown

Чтобы применить правильное форматирование текста для этого блока, строго следуйте инструкциям ниже. Инструменты разметки находятся под полем ввода сообщения.

<figure><img src="/files/a4d8c9c5f92035879b3f6598ee4f448edb819b84" alt="" width="375"><figcaption></figcaption></figure>

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

Если вы используете переменные в тексте, то на этом этапе указывать их не нужно. Иначе синтаксис переменных будет нарушен, а символы #{} также будут экранированы, и переменная не появится в тексте.

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

Выберите текст \*\* или \_ \_, и т. д.

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

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

Пример: hello\\. Рад \*видеть\* вас\\!

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

* **Жирный текст** — поставьте звёздочки с обеих сторон: \*вот текст\*
* **Курсив** — подчёркивание: \_текст\_
* **Подчёркнутый текст** — два нижних подчёркивания с обеих сторон: \_\_текст\_\_
* **Зачёркнутый**—текст — это тильда с обеих сторон текста: \~текст\~
* **Ссылка в тексте:** \[текст в квадратных скобках]\(ссылка в круглых скобках)&#x20;
* \[встроенный URL]\(<http://www.example.com> /)
* **Упоминание пользователя TG:** \[текст в квадратных скобках] (ссылка на пользователя в круглых скобках). Вы можете использовать #{platform\_id} после знака равенства в ссылке.&#x20;
* \[встроенное упоминание пользователя]\(tg://user?id=123456789)
* **Текст в виде кода** — поставьте обратный апостроф с обеих сторон текста: \`встроенный фиксированной ширины код\`
* **Скрытый текст или спойлер** - используйте || с обеих сторон текста
* Затем вставьте нужный текст, используя специальные символы.

Пример:

<figure><img src="/files/35e17085a9f8a794f330e5d741296852fb293586" alt="" width="375"><figcaption></figcaption></figure>

Результат:

<figure><img src="/files/cc3b491c2ab3c360ef1a62edd00ac1d26feed5b1" alt="" width="375"><figcaption></figcaption></figure>

**Чтобы использовать специальные символы буквально (например, \`, \*, \_, \~), их нужно экранировать обратным слешем (\\\\). Это предотвращает их интерпретацию как команд форматирования.**

**Пример:** Чтобы отобразить звёздочку (\*), напишите `\*`.

txt = tg\_escape(s), где s — строка с исходным текстом.

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

ваша переменная = "Текст первой строки" + "\n" + "Текст второй строки" + "\n" +"Третья строка"

На выходе в txt строка уже поступает со слешами, вставленными в нужных местах.

Пример:

<figure><img src="/files/e306f8b134fc2fdace354cecd942729edab523f9" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/3469aeb7f98bf0eed35a3c81c1b846cbb67fed9c" alt=""><figcaption></figcaption></figure>

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

**Вот пример с длинным текстом:**

<figure><img src="/files/9f235e9cde950123be5bba871ed01f203cdf9931" alt="" width="364"><figcaption></figcaption></figure>

Для этого используйте калькулятор, чтобы:

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

<figure><img src="/files/038f73770700c9db17c95d1b49339da899bac39d" alt="" width="375"><figcaption></figcaption></figure>

**Шаг 2. Включите кнопку "Markdown markup":**

<figure><img src="/files/3d538959e61795f46777db6cbd9c755739acc2c3" alt="" width="375"><figcaption></figcaption></figure>

Когда кнопка разметки включена, специальные символы экранируются.

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

<figure><img src="/files/8e7c2ddcf0323c1bc111faa6e91b3a2b6e6e74dc" alt="" width="375"><figcaption></figcaption></figure>

* **"Нет закрывающего символа"** - Это часто означает, что специальный символ (например, скобка `}` или кавычка `"`) был неправильно экранирован.

**Пример распространённой ошибки:**

Если сообщение не удаётся отправить и вы видите ошибку в разделе "Clients", вероятно, это связано с неверным экранированием символов. Сообщение об ошибке обычно указывает на конкретный символ, перед которым отсутствует обратный слеш (`\\`).

<br>

<figure><img src="/files/c33d0e4e7ab46afaf75ff00de17b9e9615bff5ae" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/e83e313d93003a84bdaa5c99372b5f7abccc085e" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/4bf48a9ddb7e4546a3391a9e9bcf5dfb43491a9c" alt="" width="375"><figcaption></figcaption></figure>

Форматирование текста в редакторе блоков для Telegram: markdown

### HTML-разметка

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

<figure><img src="/files/95aa4bad1540fb2fe04d4fd886a6d30235e970a5" alt="" width="375"><figcaption></figcaption></figure>

* \<a href="<https://google.com> ">ссылка\</a> - вставляет ссылку в конкретное слово.

Пример:

<figure><img src="/files/cef99fca659af99825d047f41c04b36650aa3d21" alt="" width="563"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/1d5aa3bfaec1e8273a77ac7fab26c94d9178637b" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/1152c71649e86893515f2a1e6894704ed5f09cf7" alt="" width="375"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/19201552f2cfae9a7dd1522e6badfeb906caa20d" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/19c71a6124cac540dfc2bc1b4616ed53c1969ec5" alt="" width="375"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/271ade3ad4e9684d667c868dcd16e943ce35fe67" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/563f0cad3a1f2800fb881fc3ffe68cc43eef450e" alt="" width="375"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/2dea078df7eaa058e75aa7bc49f07069e32d3c2c" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/26ba69750bc18a31f0f6d2f1bfa4262ab7d42097" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/37fd809d548544520ae8b4b8cee33046dd738538" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/c797163f2dd0f5f581564dbbd080a2bd34732a7c" alt="" width="375"><figcaption></figcaption></figure>

* \<strike>зачёркнутый\</strike> - зачёркнутый шрифт

<figure><img src="/files/d3e32b93c64af2a1f9ec03de57e5320fdc56861b" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/47e7931e2b7c260fbfa8b89b5ab3634f4fa33de7" alt="" width="375"><figcaption></figcaption></figure>

* \<span class="tg-spoiler">скрытый\</span> - скрытый шрифт

Пример:

<figure><img src="/files/42912981e626c8017008cfd5c0b060ca33f277a2" alt="" width="375"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/e506dc7f1cecb6aa7060d2d85aa92d6c21c91592" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/a380e66ad28d86c66a211e35ccb9d286e71006e1" alt="" width="375"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/44423f9448630e0fda9f56b241f5cf19c62785e2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8993289a38431a770e52b03ed3b92a2ce4d5740f" alt="" width="351"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/60c724bfb558e77977eca295c02b8309229e9cc2" alt="" width="375"><figcaption></figcaption></figure>

Защищённые сообщения нельзя пересылать, а на телефоне нельзя сделать скриншот.


---

# 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/builder/telegram_messages.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.