Telegram Bot API

Экранирование 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-бота

  1. Вставьте сам текст — имя пользователя, цену, строку лога. Свою разметку не вставляйте: экранируйте данные, а затем оборачивайте их в *bold* или <b> сами.
  2. Выберите режим: MarkdownV2 — обычный текст, MarkdownV2 — внутри code/pre, MarkdownV2 — внутри (…) ссылки или HTML. Результат обновляется по мере ввода.
  3. Нажмите Копировать или Как JSON-строку — получите значение в кавычках с удвоенными обратными слешами, готовое для JSON-тела запроса или исходного кода.
  4. По желанию откройте Проверить, введите токен бота и chat_id и отправьте результат через sendMessage с подходящим parse_mode. В режиме кода текст оборачивается в обратные кавычки, в режиме ссылки становится URL в [link](…).

Правила экранирования MarkdownV2 в Telegram

Правила взяты из официального описания форматирования Bot API:

Пример: Price: 5.99 (incl. tax) - order #42! превращается в:

Price: 5\.99 \(incl\. tax\) \- order \#42\!

Классические ловушки — точка и восклицательный знак: забудете один — и весь запрос вернёт ошибку.

parse_mode HTML в Telegram

В режиме HTML каждый <, > и &, который не входит в тег или сущность, записывается как &lt;, &gt; и &amp;. Инструмент заменяет ровно эти три символа. Правило короткое, поэтому для динамического текста 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