Escapador de MarkdownV2 y HTML para Telegram
Pega cualquier texto y obtenlo escapado para el parse mode MarkdownV2 o HTML de Telegram, para que sendMessage deje de fallar con Bad Request: can't parse entities.
MarkdownV2 exige escapar _ * [ ] ( ) ~ ` > # + - = | { } . ! con una barra invertida; dentro de code y pre solo ` y \; dentro de los (…) de un enlace solo ) y \. HTML exige < > &.
Pruébalo: enviar a un chat
El token se queda en tu navegador (localStorage) y solo se envía a api.telegram.org.
Cómo escapar Markdown para un bot de Telegram
- Pega el texto literal: un nombre de usuario, un precio, una línea de log. No pegues tus propios marcadores de formato: escapa los datos y luego envuélvelos tú mismo en
*bold*o<b>. - Elige el modo: MarkdownV2 texto normal, MarkdownV2 dentro de
code/pre, MarkdownV2 dentro de (…) de un enlace, o HTML. El resultado se actualiza mientras escribes. - Pulsa Copiar, o Como cadena JSON para obtener el valor entre comillas con las barras invertidas duplicadas, listo para un cuerpo JSON o para el código fuente.
- Opcional: abre Pruébalo, ingresa el token del bot y un
chat_idy envía el resultado consendMessagey elparse_modecorrespondiente. En modo code el texto se envuelve en comillas invertidas; en modo enlace se convierte en la URL de[link](…).
Reglas de escape de MarkdownV2 en Telegram
Las reglas vienen de las opciones de formato de la Bot API:
- En texto normal, estos caracteres deben ir precedidos de
\:_ * [ ] ( ) ~ ` > # + - = | { } . !. La herramienta también escapa la propia barra invertida. - Dentro de las entidades
preycodesolo se escapan`y\. - Dentro de la parte (…) de un enlace inline o de la definición de un emoji personalizado solo se escapan
)y\.
Ejemplo: Precio: 5.99 (IVA incl.) - pedido #42! se convierte en:
Precio: 5\.99 \(IVA incl\.\) \- pedido \#42\!
El punto y el signo de exclamación son las sorpresas clásicas: olvida uno y falla toda la solicitud.
Parse mode HTML de Telegram
En modo HTML, cada <, > y & que no forme parte de una etiqueta o entidad debe escribirse como <, > y &. La herramienta reemplaza exactamente estos tres caracteres. Como la regla es tan corta, HTML suele ser la opción más segura para texto dinámico. La lista de etiquetas admitidas está en /es/guides/telegram-bot-send-message.html.
Privacidad
El escape se hace por completo en tu navegador, sin ninguna solicitud. Solo la prueba opcional envía una solicitud sendMessage, directamente de tu navegador a api.telegram.org; el token se guarda en localStorage y nunca llega a nuestro servidor. También puedes armar la solicitud en /es/telegram-bot-api-tester.html#sendMessage. Otros textos de error se explican en /es/guides/telegram-bot-api-errors.html.
Preguntas frecuentes
¿Qué caracteres hay que escapar en MarkdownV2 de Telegram?
En texto normal: _ * [ ] ( ) ~ ` > # + - = | { } . !, cada uno precedido de una barra invertida (la barra invertida también se escapa). Dentro de code y pre solo ` y \; dentro de los (…) de un enlace solo ) y \.
¿Por qué sendMessage falla con "can't parse entities"?
El texto contiene un carácter reservado sin escapar o una entidad sin cerrar. El mensaje de error de Telegram suele indicar el carácter. Escapa las partes dinámicas del texto y deja sin escapar solo tus propios marcadores de formato.
¿Uso MarkdownV2 o HTML?
Para texto que viene de usuarios o de bases de datos, HTML suele ser más fácil: solo hay que reemplazar <, > y &. MarkdownV2 exige escapar 18 caracteres.
¿Hay que escapar el texto dentro de bloques de código?
En MarkdownV2, solo ` y \ dentro de code y pre. Elige el modo correspondiente en la herramienta. En modo HTML, los mismos tres caracteres que en cualquier otro lugar.
Otras utilidades
Buscador de chat IDValidador de initData de Mini AppVerificador de webhookBot API Tester