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

## Розмітка Markdown

Щоб правильно розмітити текст у потрібному блоці (розмітка розташована під полем введення тексту повідомлення), суворо дотримуйтеся таких кроків:

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

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

Якщо ви використовуєте змінні в тексті, ви <mark style="color:red;">**не повинні**</mark> вказувати їх на цьому етапі. Інакше синтаксис змінної буде порушено, символи #{} також буде екрановано, і змінна не з’явиться в тексті.

2. Увімкніть "Markdown у Telegram". Так у ваш текст будуть додані символи екранування.
3. Виділяємо текст \*\* або \_ \_, тощо.

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

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

Приклад: hi\\. Радий бачити \*вас\* \\!
{% endhint %}

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

**Жирний текст** — поставте зірочки по обидва боки: \* ось текст\*\
**Курсив** — підкреслення:  \_tex&#x74;*\_*\
**Підкреслений текст** — дві нижні підкреслювальні риски з обох боків: \_\_text\_\_\
**Перекреслений текст -** це тильда по обидва боки тексту: \~text\~\
Посилання в тексті: \[текст у квадратних дужках]\(посилання в дужках):\
\[inline 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/c90bac219fc1ebab6b73b257772ab06e22515077" alt="" width="563"><figcaption><p>Приклад розмітки</p></figcaption></figure></div>

Результат:

<div data-with-frame="true"><figure><img src="/files/ecb903561fd56077ae38911a708341058b60308b" 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/23061b17fcf69ce9cff8dc1c4af4a077e35881a0" alt=""><figcaption><p>Приклад екранування</p></figcaption></figure>

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

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

#### Приклад із довгим текстом:

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

Для цього потрібно скористатися калькулятором:

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

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

Крок 2. Увімкніть кнопку розмітки Markdown:

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

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

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

Якщо після надсилання повідомлення воно не дійшло до месенджера, а в діалозі в розділі Clients ви бачите помилку, це означає, що ви неправильно екранували символи.&#x20;

Водночас ви побачите помилку під час надсилання повідомлення в розділі "Clients" — вона міститиме символ, який не було екрановано.

Повідомлення про помилки, які ви можете побачити:

1. Немає символу закриття:

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

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

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

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

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

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

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

1. \<a href="[https://google.com">посилання\\](https://docs.mavibot.ai/doc/uk/chatbot/mesendzheri/telegram/https:/google.com">посилання\\)</a> - вбудовує посилання в одне слово.

Приклад заповнення:

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

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

Приклад:

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

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

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

Приклад:

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

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

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

Приклад:

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

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

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

Приклад:

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

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

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

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

\<strike>strike\</strike> - перекреслений текст

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

\<span class="tg-spoiler">hidden\</span> - прихований текст

Приклад:

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

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

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

Приклад:

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

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

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

Приклад:

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

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

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

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

<div data-with-frame="true"><figure><img src="/files/e313e6bff357bc2e8c4338fce4823024a55b5514" 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/uk/chatbot/mesendzheri/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.