Ferramenta de escape de MarkdownV2 e HTML do Telegram
Cole qualquer texto e receba-o escapado para o MarkdownV2 ou o modo HTML do Telegram, para que o sendMessage pare de falhar com Bad Request: can't parse entities.
O MarkdownV2 exige escapar _ * [ ] ( ) ~ ` > # + - = | { } . ! com uma barra invertida; dentro de code e pre, apenas ` e \; dentro dos (…) de um link, apenas ) e \. O HTML exige < > &.
Teste: enviar para um chat
O token fica no seu navegador (localStorage) e é enviado apenas para api.telegram.org.
Como escapar Markdown para um bot do Telegram
- Cole o texto literal — um nome de usuário, um preço, uma linha de log. Não cole os seus próprios marcadores de formatação: escape os dados e depois envolva-os você mesmo em
*bold*ou<b>. - Escolha o modo: MarkdownV2 texto comum, MarkdownV2 dentro de
code/pre, MarkdownV2 dentro dos (…) de um link ou HTML. O resultado é atualizado enquanto você digita. - Clique em Copiar, ou em Como string JSON para obter o valor entre aspas e com as barras invertidas duplicadas — pronto para um corpo JSON ou para o código-fonte.
- Opcional: abra Teste, informe o token do bot e um
chat_ide envie o resultado comsendMessagee oparse_modecorrespondente. No modo code o texto é envolvido em crases; no modo link ele vira a URL de[link](…).
Regras de escape do MarkdownV2 no Telegram
As regras vêm das opções de formatação do Bot API:
- No texto comum, estes caracteres devem ser precedidos por
\:_ * [ ] ( ) ~ ` > # + - = | { } . !. A ferramenta também escapa a própria barra invertida. - Dentro das entidades
preecode, apenas`e\são escapados. - Dentro da parte (…) de um link inline ou da definição de um emoji personalizado, apenas
)e\são escapados.
Exemplo: Price: 5.99 (incl. tax) - order #42! vira:
Price: 5\.99 \(incl\. tax\) \- order \#42\!
O ponto e o ponto de exclamação são as surpresas clássicas: esqueça um deles e a requisição inteira falha.
Modo HTML do Telegram
No modo HTML, todo <, > e & que não faz parte de uma tag ou entidade deve ser escrito como <, > e &. A ferramenta substitui exatamente esses três caracteres. Como a regra é tão curta, o HTML costuma ser a opção mais segura para texto dinâmico. A lista de tags suportadas está em /pt/guides/telegram-bot-send-message.html.
Privacidade
O escape acontece inteiramente no seu navegador — nenhuma requisição é feita. Só o teste opcional envia uma requisição sendMessage, direto do navegador para api.telegram.org; o token fica no localStorage e nunca chega ao nosso servidor. Você também pode montar a requisição no /pt/telegram-bot-api-tester.html#sendMessage. Outros textos de erro são explicados em /pt/guides/telegram-bot-api-errors.html.
Perguntas frequentes
Quais caracteres precisam de escape no MarkdownV2 do Telegram?
No texto comum: _ * [ ] ( ) ~ ` > # + - = | { } . !, cada um precedido por uma barra invertida (a própria barra invertida também é escapada). Dentro de code e pre, apenas ` e \; dentro dos (…) de um link, apenas ) e \.
Por que o sendMessage falha com "can't parse entities"?
O texto contém um caractere reservado sem escape ou uma entidade que não foi fechada. A mensagem de erro do Telegram costuma indicar o caractere. Escape as partes dinâmicas do texto e deixe sem escape apenas os seus próprios marcadores de formatação.
Devo usar MarkdownV2 ou HTML?
Para texto vindo de usuários ou de bancos de dados, o HTML costuma ser mais fácil: só <, > e & precisam ser substituídos. O MarkdownV2 exige escapar 18 caracteres.
Preciso escapar o texto dentro de blocos de código?
No MarkdownV2, apenas ` e \ dentro de code e pre. Escolha o modo correspondente na ferramenta. No modo HTML, os mesmos três caracteres de sempre.
Outros utilitários
Localizador de chat IDValidador de initData do Mini AppVerificador de webhookBot API Tester