# Форматирование сообщений в Telegram
## Разметка Markdown
Для правильной разметки текста в нужном блоке (разметка находится под полем для ввода текста сообщения) строго соблюдайте следующие шаги:
1. Ставим нужный текст в поле ответ.
Если вы используете переменные в тексте, то на данном этапе их указывать **не нужно**. В противном случае синтаксис переменных будет нарушен и знаки #{} также будут экранированы, а переменная не отобразится в тексте.
2. Включаем "Markdown в Telegram". Так в ваш текст будут добавлены символы экранирования.
3. Выделяем текст \*\* либо \_ \_ и т.п.
{% hint style="danger" %}
Если в этом блоке встречаются символы из перечисленных: '\_', '\*', '\[', ']', '(', ')', '\~', '\`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' — их нужно экранировать, добавлять перед ними обратный слэш \\
Иначе сообщение не отправится вообще. При этом не имеет значения, какой участок текста вы размечаете.
Пример: привет\\. Рады \*тебя\* видеть\\!
{% endhint %}
Спецсимволы:
**Жирный текст** — с обеих сторон ставите звездочки: \*тут текст\*\
**Курсив** — нижнее подчёркивание: \_текст\_\
**Подчеркнутый текст** — два нижних подчеркивания с обеих сторон: \_\_текст\_\_\
**Зачеркнутый текст** — тильда с обеих сторон текста: \~текст\~\
**Ссылка в тексте**: \[текст в квадратных скобках]\(ссылка в круглых скобках) \
\[inline URL]\([http://www.example.com/](https://vk.com/away.php?to=http%3A%2F%2Fwww.example.com%2F\&cc_key=))\
**Упоминание пользователя ТГ**: \[текст в квадратных скобках]\(ссылка на пользователя в круглых скобках). В ссылке после знака равно можно использовать #{platform\_id} \
\[inline mention of a user]\(tg://user?id=123456789)\
**Текст в виде кода** — с обеих сторон текста поставить обратный апостроф: \`inline fixed-width code\`\
**Скрытый текст или spoiler** - с обеих сторон от текста используйте ||
4. Далее размечаете нужный текст при помощи спецсимволов.
**Пример:**
Пример разметки
Результат:
При работе с Markdown необходимо не забывать, что спецсимволы следует экранировать, заменить в тексте управляющие символы на соответствующие текстовые подстановки. Делается это достаточно просто - перед спецсимволом добавляется **обратный слэш \\** или при помощи функции Калькулятора
**txt = tg\_escape(s), где** **s** - строка с исходным текстом.
{% hint style="info" %}
Чтобы в переменную записать текст с переносами строк, укажите значение следующим образом:
`ваша_переменная = "Текст первой строки" + "\n" + "Текст второй строки" + "\n" +"Третья строка"`
{% endhint %}
На выходе в **txt** приходит строка уже с вставленными слешами в нужных местах.
**Пример:**
Пример экранирования
Как выглядит текст в Telegram
Далее размечаете нужный текст.
#### Пример с длинным текстом:
Для этого в калькуляторе необходимо:
Шаг 1. Вставить текст в поле сообщения:
Шаг 2. Включить кнопку разметки Marldown:
При включении кнопки разметки, экранируются спецсимволы
Шаг 3. Расставляем спецсимволы для форматирования сообщения по тексту:
Если после отправки сообщения, оно не дошло в мессенджер, а в диалоге в разделе Клиенты вы видите ошибку, значит вы неверно экранировали символы.
При этом вы увидите ошибку при отправке сообщения в разделе "Клиенты", в ней будет указан символ, который не был экранирован.
Сообщения об ошибках, которые вы можете встретить:
1. Нет закрывающего символа:
2. Отсутствует экранирование символа:
Ознакомьтесь с особенностями разметки текста в видео ниже и выполните экранирование правильно:
{% embed url="" %}
Форматирование текста в редакторе блока для Telegram: markdown
{% endembed %}
## Разметка HTML
Чтобы разметка HTML работала, не забудьте нажать на кнопку HTML под текстовым полем для сообщения:
1. \ссылка\\](https://docs.salebot.pro/chat-boty/podklyuchenie-messendzherov-i-kanalov/telegram/https:/google.com">ссылка\\) - вшивает ссылку в определенное слово.
Пример заполнения:
2. \underlined\ - подчеркнутый шрифт
Пример:
## Как включить защищенный режим для контента
Чтобы защитить контент от распространения можно включить защищенный режим для сообщений. Для этого в разделе "Сообщение" включите "Защитить контент":
{% hint style="info" %}
Защищенные сообщения нельзя переслать, на телефоне нельзя сделать скриншот.
{% endhint %}
{% embed url="" %}
Telegram: защита контента, редактор блока
{% endembed %}
---
# 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.salebot.pro/chat-boty/podklyuchenie-messendzherov-i-kanalov/telegram/formatirovanie-soobshenii-v-telegram.md?ask=
```
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.
