Екранування 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 часто надійніший. Перелік підтримуваних тегів — у гайді /uk/guides/telegram-bot-send-message.html.
Конфіденційність
Екранування відбувається повністю в браузері, без жодних запитів. Лише необов’язкова перевірка надсилає один запит sendMessage — напряму з браузера на api.telegram.org; токен зберігається в localStorage і не потрапляє на наш сервер. Зібрати запит вручну можна в /uk/telegram-bot-api-tester.html#sendMessage. Інші тексти помилок розібрано в /uk/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