# Форматування повідомлень у Telegram

### Розмітка Markdown

Щоб застосувати правильне форматування тексту для цього блоку, суворо дотримуйтеся наведених нижче кроків. Інструменти розмітки розташовані під полем введення повідомлення.

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

* Помістіть потрібний текст у поле відповіді.

Якщо ви використовуєте змінні в тексті, то на цьому етапі вказувати їх не потрібно. Інакше буде порушено синтаксис змінних, а також символи #{} буде екрановано, і змінна не з’явиться в тексті.

* Увімкніть "Markdown у Telegram". Таким чином до вашого тексту буде додано символи екранування.

Виберіть текст \*\* або \_ \_, тощо.

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

Інакше повідомлення взагалі не буде надіслано. Не має значення, яку саме частину тексту ви розмітите.

Приклад: hello\\. Glad \*to\* see you\\!

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

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

Приклад:

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

Результат:

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

**Щоб використовувати спеціальні символи буквально (наприклад, \`, \*, \_, \~), потрібно екранувати їх зворотною скісною рискою (\\). Це запобігає їх інтерпретації як команд форматування.**

**Приклад:** Щоб відобразити зірочку (\*), напишіть `\*`.

txt = tg\_escape(s), де s — це рядок із вихідним текстом.

Щоб записати текст із розривами рядків у змінну, вкажіть значення так:

your variable = "Текст першого рядка" + "\n" + "Текст другого рядка" + "\n" +"Третій рядок"

Після виведення в txt уже вставлені слеші в правильних місцях.

Приклад:

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

<figure><img src="/files/798333e3f97f046e561531d7ae740113a3c97067" alt=""><figcaption></figcaption></figure>

Потім розмітьте потрібний текст.

**Ось приклад із довгим текстом:**

<figure><img src="/files/54f95a18cfa9653c03d17359abaed230d8f88945" alt="" width="364"><figcaption></figcaption></figure>

Для цього скористайтеся калькулятором, щоб:

**Крок 1. Вставте свій текст у поле повідомлення:**

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

**Крок 2. Увімкніть кнопку "Markdown markup":**

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

Коли кнопка розмітки увімкнена, спеціальні символи екрануються.

**Крок 3. Розставте в тексті спеціальні символи для форматування повідомлення:**

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

* **"Немає символу закриття"** - Це часто означає, що спеціальний символ (наприклад, дужка `}` або лапка `"`) не було належним чином екрановано.

**Поширений приклад помилки:**

Якщо повідомлення не вдається надіслати, і ви бачите помилку в розділі "Clients", імовірно, це пов’язано з неправильним екрануванням символів. У повідомленні про помилку зазвичай буде вказано конкретний символ, перед яким відсутня зворотна скісна риска (`\`).

<br>

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

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

* Екранування символу відсутнє:

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

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

### HTML-розмітка

Щоб HTML-розмітка працювала, не забудьте натиснути кнопку HTML під полем тексту для повідомлення:

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

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

Приклад:

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

* \<u>підкреслений\</u> - підкреслений шрифт

Приклад:

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

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

* \<ins>підкреслений\</ins> - підкреслений шрифт

Приклад:

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

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

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

Приклад:

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

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

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

Приклад:

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

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

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

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

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

* \<strike>закреслений\</strike> - закреслений шрифт

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

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

* \<span class="tg-spoiler">прихований\</span> - прихований шрифт

Приклад:

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

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

Приклад:

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

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

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

Приклад:

<figure><img src="/files/3c757223824358012ee54b8bfe08e573fc2b055c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6e9da78ac896f6e1f76eb2874e6d5914248f23d1" alt="" width="351"><figcaption></figcaption></figure>

### Як увімкнути захищений режим для контенту

Щоб захистити контент від поширення, ви можете увімкнути захищений режим для повідомлень. Для цього ввімкніть "Protect content" у розділі "Message":

<figure><img src="/files/d37306a8c411f52c7f7d689f17c745f9beb71e41" 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/uk/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.
