Экранирование MarkdownV2 и HTML для Telegram-бота
Вставьте любой текст и получите его экранированным для Telegram MarkdownV2 или parse_mode HTML — чтобы sendMessage больше не падал с ошибкой Bad Request: can't parse entities.
MarkdownV2 требует экранировать _ * [ ] ( ) ~ ` > # + - = | { } . ! обратным слешем; внутри code и pre — только ` и \; внутри (…) ссылки — только ) и \. HTML требует < > &.
Проверить: отправить в чат
Токен остаётся в вашем браузере (localStorage) и отправляется только на api.telegram.org.
Как экранировать Markdown для Telegram-бота
- Вставьте сам текст — имя пользователя, цену, строку лога. Свою разметку не вставляйте: экранируйте данные, а затем оборачивайте их в
*bold*или<b>сами. - Выберите режим: MarkdownV2 — обычный текст, MarkdownV2 — внутри
code/pre, MarkdownV2 — внутри (…) ссылки или HTML. Результат обновляется по мере ввода. - Нажмите Копировать или Как JSON-строку — получите значение в кавычках с удвоенными обратными слешами, готовое для JSON-тела запроса или исходного кода.
- По желанию откройте Проверить, введите токен бота и
chat_idи отправьте результат черезsendMessageс подходящимparse_mode. В режиме кода текст оборачивается в обратные кавычки, в режиме ссылки становится URL в[link](…).
Правила экранирования MarkdownV2 в Telegram
Правила взяты из официального описания форматирования Bot API:
- В обычном тексте перед этими символами ставится
\:_ * [ ] ( ) ~ ` > # + - = | { } . !. Инструмент экранирует и сам обратный слеш. - Внутри сущностей
preиcodeэкранируются только`и\. - Внутри части (…) inline-ссылки или custom emoji — только
)и\.
Пример: Price: 5.99 (incl. tax) - order #42! превращается в:
Price: 5\.99 \(incl\. tax\) \- order \#42\!
Классические ловушки — точка и восклицательный знак: забудете один — и весь запрос вернёт ошибку.
parse_mode HTML в Telegram
В режиме HTML каждый <, > и &, который не входит в тег или сущность, записывается как <, > и &. Инструмент заменяет ровно эти три символа. Правило короткое, поэтому для динамического текста HTML часто надёжнее. Список поддерживаемых тегов — в гайде /ru/guides/telegram-bot-send-message.html.
Конфиденциальность
Экранирование выполняется целиком в браузере, без запросов. Только необязательная проверка отправляет один запрос sendMessage — напрямую из браузера на api.telegram.org; токен хранится в localStorage и не попадает на наш сервер. Собрать запрос вручную можно в /ru/telegram-bot-api-tester.html#sendMessage. Другие тексты ошибок разобраны в /ru/guides/telegram-bot-api-errors.html.
Частые вопросы
Какие символы нужно экранировать в Telegram MarkdownV2?
В обычном тексте: _ * [ ] ( ) ~ ` > # + - = | { } . ! — обратным слешем перед каждым (сам обратный слеш тоже экранируется). Внутри code и pre — только ` и \; внутри (…) ссылки — только ) и \.
Почему sendMessage возвращает «can't parse entities»?
В тексте есть неэкранированный зарезервированный символ или незакрытая сущность. Обычно Telegram называет символ в тексте ошибки. Экранируйте переменные части текста, а свою разметку оставляйте как есть.
Что выбрать: MarkdownV2 или HTML?
Для текста от пользователей или из базы обычно проще HTML: заменять нужно только <, > и &. В MarkdownV2 экранируются 18 символов.
Нужно ли экранировать текст внутри блоков кода?
В MarkdownV2 внутри code и pre — только ` и \; выберите соответствующий режим в инструменте. В HTML — те же три символа, что и везде.
Другие утилиты
Поиск chat IDВалидатор initData Mini AppПроверка вебхукаBot API Tester