# Escapar MarkdownV2 do Telegram | Adeus ao can't parse entities

> Escape online e grátis os 18 caracteres reservados do MarkdownV2 para a Bot API do Telegram. Dois modos, links e código protegidos, aviso de entidades não fechadas e código pronto para cURL, aiogram ou grammY.

- **Fonte (source):** https://ae.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215/f/escape-markdownv2-telegram-bot-api
- **Plataforma (platform):** AiToolsForApps
- **Idioma (language):** pt

## Em resumo

- Escape MarkdownV2 no Telegram sem quebrar a mensagem
- Cole seu texto e receba a versão escapada pronta para parse_mode: MarkdownV2, com os 18 caracteres reservados resolvidos e as barras adicionadas destacadas. Grátis, no seu navegador e sem conta.
- Os 18 reservados, exatamente os que a especificação diz
- Dos modos de verdade, não um
- Escapado por contexto, não por força bruta

## Escape MarkdownV2 no Telegram sem quebrar a mensagem

O escapador de MarkdownV2 do Telegram pega o texto que você vai enviar com a Bot API e devolve o mesmo texto preparado para `parse_mode: "MarkdownV2"`. Escapa os dezoito caracteres que o Telegram declara reservados —_ * [ ] ( ) ~ ` > # + - = | { } . !— e te mostra o resultado com cada barra invertida que foi adicionada em outra cor, para que você veja exatamente o que foi alterado e por quê.

Ele tem dois modos, porque escapar nem sempre significa a mesma coisa. No modo Literal todo o seu texto é texto: nenhum asterisco ou sublinhado é interpretado como formatação, então o que você escreve é o que é lido. No modo Com formatação, as marcas que você colocou intencionalmente —negrito, itálico, sublinhado, riscado, spoiler e citações no início da linha— são respeitadas e tudo o mais é escapado. Uma marca que você abre e não fecha não vaza: se torna um caractere literal e te avisa.

O que diferencia este escapador de um replace com expressão regular é que ele entende o contexto. Dentro de `código em linha` e dos blocos ``` apenas o acento grave e a barra invertida são escapados, como pede a especificação. Em um link `[texto](url)`, o texto visível é escapado e o destino não, exceto pelo parêntese de fechamento e a barra: assim, suas URLs chegam intactas em vez de se encherem de barras e deixarem de funcionar. Ele também reconhece emojis personalizados `![x](tg://emoji?id=…)` e os deixa passar inteiros.

E antes que a mensagem saia, ele revisa. Detecta entidades abertas e não fechadas e te diz qual é —negrito, itálico, código, bloco, colchete— com um botão para fechá-la ou escapá-la em um clique. Avisa se um link não começa com https:// ou tg://, se o destino tem caracteres não ASCII que você deveria codificar, se o texto já vinha com barras invertidas e você ia escapá-lo duas vezes, e se ultrapassa os 4096 caracteres que o Telegram corta. Abaixo você tem a pré-visualização em uma bolha real do Telegram, construída lendo o texto escapado, e o trecho de código já montado para cURL, a Bot API em bruto, python-telegram-bot, aiogram, telegraf ou grammY.

## O que inclui

- **Os 18 reservados, exatamente os que a especificação diz** — _ * [ ] ( ) ~ ` > # + - = | { } . ! — sem esquecer o ponto e a exclamação, que são os que mais quebram mensagens.
- **Dos modos de verdade, não um** — Literal para que seu texto seja texto, e Com formatação para manter o negrito, o itálico, o sublinhado, o tachado, o spoiler e a citação, escapando todo o resto.
- **Escapado por contexto, não por força bruta** — o código em linha e os blocos ``` recebem apenas o escape que a especificação pede, e nos links o texto visível é escapado, mas não a URL, então seus links continuam funcionando.
- **Você vê o que mudou** — cada barra invertida adicionada é destacada sobre o texto original, e os trechos tratados como link ou como código são marcados separadamente. Nada de confiar cegamente em uma caixa preta.
- **Avisa antes que a Bot API te retorne o 400** — entidades não fechadas com seu nome, colchetes órfãos, acentos invertidos soltos, links sem https://, URLs com caracteres não ASCII, texto já escapado e mensagens com mais de 4096 caracteres.
- **Correções com um clique** — cada aviso traz seu botão —fechar a entidade, escapar o caractere ou remover as barras que o texto já tinha— e o escapado é recalculado instantaneamente sobre o resultado.
- **Pré-visualização em bolha real do Telegram** — o texto escapado é reinterpretado e exibido como o usuário verá, em tema claro e escuro, antes de enviar qualquer coisa.
- **E o código já montado** — copie o trecho pronto para cURL, a Bot API em bruto, python-telegram-bot, aiogram, telegraf ou grammY, com marcadores de token em vez de credenciais reais. Nunca pedimos o token do seu bot.

## Perguntas frequentes

### Por que o erro can't parse entities aparece ao enviar uma mensagem com MarkdownV2?

Porque o texto contém algum dos 18 caracteres que o MarkdownV2 considera reservados sem sua barra invertida na frente: _ * [ ] ( ) ~ ` > # + - = | { } . ! O Telegram tenta interpretá-los como marcas de formatação, não encontra o fechamento que espera e rejeita a mensagem com um erro 400 "can't parse entities". Os culpados mais frequentes são o ponto final de uma frase, o hífen de uma lista e os parênteses, precisamente porque ninguém os associa a formatação. O escaper de MarkdownV2 do Telegram percorre seu texto e adiciona a barra invertida onde necessário, destacando cada uma para que você veja o que foi alterado, e ainda te avisa se o que quebra a mensagem é uma entidade aberta e sem fechamento em vez de um caractere solto.

### Quais caracteres precisam ser escapados no MarkdownV2 do Telegram?

São dezoito: o sublinhado (_), o asterisco (*), os colchetes ([ e ]), os parênteses (( e )), a til (~), o acento grave (`), o sinal maior que (>), a hashtag (#), o sinal de mais (+), o hífen (-), o igual (=), a barra vertical (|), as chaves ({ e }), o ponto (.) e a exclamação (!). Dentro de um bloco de código ou de um trecho de código em linha, a regra muda: lá apenas o acento grave e a barra invertida são escapados. E em um link [texto](url), é necessário escapar o texto visível, mas no destino apenas o parêntese de fechamento e a barra invertida: se você escapar a URL inteira, ela deixa de funcionar. O Telegram aplica cada uma dessas três regras em seu respectivo trecho.

### Posso escapar o texto sem perder a negrita e a itálica que coloquei intencionalmente?

Sim, para isso existe o modo Com formatação. Nesse modo, o escaper distingue entre as marcas que você colocou intencionalmente —*negrita*, _itálica_, __sublinhado__, ~tachado~, ||spoiler|| e a citação > no início da linha— e o restante do texto, que é escapado. Uma marca de abertura que não tenha seu fechamento mais adiante não fica pela metade: ela se torna um caractere literal e você recebe um aviso com o nome da entidade afetada e um botão para fechá-la. Se o que você quer é o contrário, que absolutamente nada seja interpretado como formatação, use o modo Literal: lá os 18 reservados são todos escapados e o que você escreve é exatamente o que se lê.

### É necessário se registrar ou fornecer o token do meu bot para usar o escaper?

Não para ambas as coisas. O escapado, a detecção de entidades não fechadas, a pré-visualização e o trecho de código são calculados integralmente no seu navegador: você pode usá-lo sem criar conta, sem limite de vezes e sem custo. E o app nunca pede o token do seu bot nem envia nada para a Bot API em seu nome: os trechos de código que você copia levam marcadores como <SEU_TOKEN> e <CHAT_ID> que você preenche em seu próprio ambiente. A única coisa que precisa de uma conta gratuita é salvar uma mensagem com seu texto e seus botões para reutilizá-la outro dia.

### O escaper quebra os links ou o código da minha mensagem?

Não, porque não é uma substituição cega de caracteres: ele tokeniza o texto por contextos antes de escapar. Reconhece os links [texto](https://…), o código em linha entre acentos invertidos, os blocos ``` com sua etiqueta de linguagem e os emojis personalizados ![x](tg://emoji?id=…), e aplica a cada trecho a regra que lhe corresponde. Na prática, isso significa que sua URL chega inteira, seu trecho de código não fica cheio de barras invertidas e a etiqueta de linguagem do bloco é preservada. Além disso, se um link não começa com https:// ou tg://, ou se o destino contém caracteres não ASCII que deveriam ser codificados, ele avisa você em vez de deixar que você descubra isso em produção.

- [Telegram — Stickers, emojis e branding para canais do Telegram com IA](https://ae.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215)

## Sobre a plataforma

**Telegram — Stickers, emojis e branding para canais do Telegram com IA** — uma aplicação de AiToolsForApps. Disponível em: https://ae.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215/f/escape-markdownv2-telegram-bot-api

### Outros idiomas

- `es`: https://ae.aitoolsforapps.com/es/aitelegram-stickers-emojis-y-branding-para-telegram-215/f/escapar-markdownv2-telegram-bot-api
- `en`: https://ae.aitoolsforapps.com/en/aitelegram-stickers-emojis-and-branding-for-telegram-215/f/escape-markdownv2-telegram-bot-api
- `fr`: https://ae.aitoolsforapps.com/fr/aitelegram-stickers-emojis-et-branding-pour-telegram-215/f/escape-markdownv2-telegram-bot-api
- `it`: https://ae.aitoolsforapps.com/it/aitelegram-stickers-emojis-e-branding-per-telegram-215/f/escape-markdownv2-telegram-bot-api
- `de`: https://ae.aitoolsforapps.com/de/aitelegram-stickers-emojis-und-branding-fuer-telegram-215/f/escape-markdownv2-telegram-bot-api
- `bg`: https://ae.aitoolsforapps.com/bg/telegram-sazdavayte-stikeri-i-emodzhita-koito-stickers-priema-215/f/ekranirane-na-markdownv2-telegram-bot-api
- `ja`: https://ae.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-markdownv2-escape-bot-api
- `nl`: https://ae.aitoolsforapps.com/nl/telegram-maak-telegram-stickers-en-emoji-s-die-stickers-accepteert-215/f/markdownv2-escapen-telegram-bot-api
- `ko`: https://ae.aitoolsforapps.com/ko/telegram-sticker-emoji-channel-branding-215/f/telegram-markdownv2-escape-bot-api
- `sv`: https://ae.aitoolsforapps.com/sv/telegram-skapa-telegram-stickers-och-emojis-som-stickers-godkanner-215/f/skydda-markdownv2-telegram-bot-api
- `da`: https://ae.aitoolsforapps.com/da/telegram-lav-telegram-stickers-og-emojis-som-stickers-accepterer-215/f/escape-markdownv2-telegram-bot-api
- `id`: https://ae.aitoolsforapps.com/id/telegram-buat-stiker-dan-emoji-telegram-yang-diterima-stickers-215/f/escape-markdownv2-telegram-bot-api
- `cs`: https://ae.aitoolsforapps.com/cs/telegram-stickery-a-emoji-pro-telegram-ktere-stickers-prijme-215/f/osetreni-markdownv2-telegram-bot-api
- `fi`: https://ae.aitoolsforapps.com/fi/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/escapeta-markdownv2-telegram-bot-api
- `zh`: https://ae.aitoolsforapps.com/zh/telegram-stickers-emojis-branding-215/f/tiaotuo-markdownv2-telegram-bot-api
- `pl`: https://ae.aitoolsforapps.com/pl/telegram-tworz-stickery-i-emoji-ktore-przyjmie-stickers-215/f/escapowanie-markdownv2-telegram-bot-api
- `no`: https://ae.aitoolsforapps.com/no/telegram-lag-telegram-stickers-og-emojier-stickers-godtar-215/f/escape-markdownv2-telegram-bot-api
- `ar`: https://ae.aitoolsforapps.com/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215/f/escape-markdownv2-telegram-bot-api
- `he`: https://ae.aitoolsforapps.com/he/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/escape-markdownv2-telegram-bot-api
