# 텔레그램 MarkdownV2 이스케이프 | can't parse entities 해결

> Telegram Bot API용 MarkdownV2 예약 문자 18개를 온라인에서 무료로 이스케이프하세요. 두 가지 모드, 링크와 코드 보호, 닫히지 않은 엔티티 경고, cURL, aiogram, grammY용 코드 제공.

- **출처 (source):** https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215/f/telegram-markdownv2-escape-bot-api
- **플랫폼 (platform):** AiToolsForApps
- **언어 (language):** ko

## 요약

- 메시지를 망가뜨리지 않고 Telegram MarkdownV2 이스케이프하기
- 텍스트를 붙여 넣으면 parse_mode: MarkdownV2에 바로 쓸 수 있는 이스케이프된 버전을 받아요. 예약 문자 18개가 처리되고 추가된 백슬래시가 강조돼요. 무료, 브라우저에서 실행, 계정 불필요.
- 사양에 나와 있는 예약 문자 18개 전부
- 모드가 하나가 아니라 둘이에요. 리터럴은 텍스트를 그대로 텍스트로 처리하고, 서식 유지는 굵게, 기울임, 밑줄, 취소선, 스포일러, 인용은 유지하면서 나머지는 모두 이스케이프해요.
- 무작정이 아니라 문맥별 이스케이프

## 메시지를 망가뜨리지 않고 Telegram MarkdownV2 이스케이프하기

Telegram MarkdownV2 이스케이퍼는 Bot API로 보낼 텍스트를 받아서 `parse_mode: "MarkdownV2"`에 맞게 준비한 같은 텍스트를 돌려줘요. Telegram이 예약 문자로 선언한 열여덟 개 문자 _ * [ ] ( ) ~ ` > # + - = | { } . ! 를 이스케이프하고, 추가한 백슬래시마다 다른 색으로 표시해서 정확히 무엇을 왜 건드렸는지 보여 줘요.

이스케이프가 항상 같은 뜻은 아니기 때문에 모드가 두 가지예요. 리터럴 모드에서는 모든 텍스트가 텍스트예요. 별표나 밑줄이 서식으로 해석되지 않으므로 입력한 그대로 읽혀요. 서식 유지 모드에서는 의도적으로 넣은 표시(굵게, 기울임, 밑줄, 취소선, 스포일러, 줄 맨 앞의 인용)는 유지하고 나머지는 모두 이스케이프해요. 열고 닫지 않은 표시는 그냥 넘어가지 않고 리터럴 문자로 바뀌며 경고가 나와요.

이 이스케이퍼가 정규식 replace와 다른 점은 문맥을 이해한다는 거예요. `인라인 코드`와 ``` 블록 안에서는 사양대로 백틱과 백슬래시만 이스케이프해요. `[텍스트](url)` 링크에서는 보이는 텍스트는 이스케이프하고 대상은 닫는 괄호와 백슬래시를 제외하고 이스케이프하지 않아서, URL이 백슬래시로 가득 차 작동하지 않게 되는 대신 그대로 전달돼요. 커스텀 이모지 `![x](tg://emoji?id=…)`도 인식해서 그대로 통과시켜요.

메시지가 나가기 전에 점검도 해요. 열리고 닫히지 않은 엔티티를 찾아 굵게, 기울임, 코드, 블록, 대괄호 중 무엇인지 알려 주고, 한 번의 클릭으로 닫거나 이스케이프하는 버튼을 제공해요. 링크가 https:// 나 tg://로 시작하지 않을 때, 대상에 인코딩해야 할 ASCII 이외 문자가 있을 때, 텍스트에 이미 백슬래시가 있어서 두 번 이스케이프하게 될 때, Telegram이 잘라 내는 4096자를 넘을 때 경고해요. 아래에는 이스케이프된 텍스트를 읽어 만든 실제 Telegram 말풍선 미리보기와, cURL, 원시 Bot API, python-telegram-bot, aiogram, telegraf, grammY용으로 완성된 코드 조각이 있어요.

## 포함된 내용

- **사양에 나와 있는 예약 문자 18개 전부** — _ * [ ] ( ) ~ ` > # + - = | { } . ! 마침표와 느낌표도 빠뜨리지 않아요. 메시지를 가장 많이 망가뜨리는 문자들이에요.
- 모드가 하나가 아니라 둘이에요. 리터럴은 텍스트를 그대로 텍스트로 처리하고, 서식 유지는 굵게, 기울임, 밑줄, 취소선, 스포일러, 인용은 유지하면서 나머지는 모두 이스케이프해요.
- **무작정이 아니라 문맥별 이스케이프** — 인라인 코드와 ``` 블록에는 사양이 요구하는 이스케이프만 적용하고, 링크는 보이는 텍스트만 이스케이프하고 URL은 건드리지 않아서 링크가 계속 작동해요.
- 바뀐 부분이 보여요. 추가된 백슬래시마다 원본 텍스트 위에 강조 표시되고, 링크나 코드로 처리된 구간은 따로 표시돼요. 블랙박스를 맹목적으로 믿을 필요가 없어요.
- **Bot API가 400을 돌려주기 전에 경고해요. 이름이 표시되는 닫히지 않은 엔티티, 짝 없는 대괄호, 혼자 있는 백틱, https** — //가 없는 링크, ASCII가 아닌 문자가 있는 URL, 이미 이스케이프된 텍스트, 4096자를 넘는 메시지를 알려 줘요.
- **한 번의 클릭으로 해결** — 경고마다 버튼이 있어서 엔티티 닫기, 문자 이스케이프, 텍스트에 이미 있던 백슬래시 제거를 할 수 있고, 결과에 대해 이스케이프가 즉시 다시 계산돼요.
- **실제 Telegram 말풍선으로 미리보기** — 이스케이프된 텍스트를 다시 해석해서 사용자에게 보일 모습 그대로, 밝은 테마와 어두운 테마로 전송하기 전에 보여 줘요.
- 코드도 완성되어 있어요. cURL, 원시 Bot API, python-telegram-bot, aiogram, telegraf, grammY용으로 바로 쓸 수 있는 코드 조각을 복사하세요. 실제 자격 증명 대신 토큰 자리 표시자가 들어 있어요. 봇 토큰은 절대 요구하지 않아요.

## 자주 묻는 질문

### MarkdownV2로 메시지를 보낼 때 can't parse entities 오류가 나는 이유가 뭔가요?

텍스트에 MarkdownV2가 앞에 백슬래시가 없으면 예약 문자로 취급하는 18개 문자 중 하나가 들어 있기 때문이에요: _ * [ ] ( ) ~ ` > # + - = | { } . ! Telegram은 이 문자들을 서식 표시로 해석하려고 하다가 기대한 닫는 표시를 찾지 못하면 400 "can't parse entities" 오류와 함께 메시지를 거부해요. 가장 흔한 원인은 문장 끝의 마침표, 목록의 하이픈, 괄호예요. 아무도 이것들을 서식과 연관 짓지 않기 때문이에요. Telegram MarkdownV2 이스케이퍼는 텍스트를 훑으며 필요한 곳에 백슬래시를 추가하고, 건드린 곳을 알 수 있도록 하나하나 강조해 줘요. 메시지를 망가뜨리는 것이 낱개 문자가 아니라 열리고 닫히지 않은 엔티티라면 그것도 알려 줘요.

### Telegram MarkdownV2에서는 어떤 문자를 이스케이프해야 하나요?

열여덟 개예요. 밑줄(_), 별표(*), 대괄호([ 와 ]), 소괄호(( 와 )), 물결표(~), 백틱(`), 부등호 >, 샵(#), 더하기(+), 하이픈(-), 등호(=), 세로선(|), 중괄호({ 와 }), 마침표(.), 느낌표(!)예요. 코드 블록이나 인라인 코드 구간 안에서는 규칙이 달라서 백틱과 백슬래시만 이스케이프해요. 그리고 [텍스트](url) 링크에서는 보이는 텍스트는 이스케이프해야 하지만 대상 주소는 닫는 괄호와 백슬래시만 이스케이프해요. URL 전체를 이스케이프하면 작동하지 않아요. Telegram 앱은 이 세 가지 규칙을 각 구간에 맞게 적용해요.

### 의도적으로 넣은 굵게와 기울임을 유지하면서 텍스트를 이스케이프할 수 있나요?

네, 그래서 서식 유지 모드가 있어요. 이 모드에서 이스케이퍼는 의도적으로 넣은 표시(*굵게*, _기울임_, __밑줄__, ~취소선~, ||스포일러||, 줄 맨 앞의 > 인용)와 나머지 텍스트를 구분해서 나머지만 이스케이프해요. 뒤에서 닫히지 않은 여는 표시는 어정쩡하게 남지 않고 리터럴 문자로 바뀌며, 해당 엔티티의 이름과 닫기 버튼이 있는 경고가 나타나요. 반대로 어떤 것도 서식으로 해석되지 않기를 원한다면 리터럴 모드를 쓰세요. 그 모드에서는 예약 문자 18개가 모두 이스케이프되어 입력한 그대로 읽혀요.

### 이스케이퍼를 쓰려면 회원가입이나 봇 토큰이 필요한가요?

둘 다 필요 없어요. 이스케이프, 닫히지 않은 엔티티 감지, 미리보기, 코드 조각은 모두 브라우저에서 계산돼요. 계정 없이, 횟수 제한 없이, 비용 없이 사용할 수 있어요. 앱은 봇 토큰을 요구하지 않으며 Bot API로 대신 보내는 것도 없어요. 복사하는 코드 조각에는 <TU_TOKEN>, <CHAT_ID> 같은 자리 표시자가 들어 있고, 본인 환경에서 직접 채우시면 돼요. 무료 계정이 필요한 것은 메시지를 텍스트와 버튼과 함께 저장해 나중에 다시 쓸 때뿐이에요.

### 이스케이퍼가 메시지의 링크나 코드를 망가뜨리지는 않나요?

아니요. 단순한 문자 치환이 아니라 이스케이프하기 전에 문맥별로 텍스트를 토큰화하기 때문이에요. [텍스트](https://…) 링크, 백틱 사이의 인라인 코드, 언어 태그가 있는 ``` 블록, 커스텀 이모지 ![x](tg://emoji?id=…)를 인식하고 구간마다 알맞은 규칙을 적용해요. 실제로는 URL이 온전하게 전달되고, 코드 조각에 백슬래시가 가득 차지 않으며, 블록의 언어 태그도 유지된다는 뜻이에요. 또 링크가 https:// 나 tg://로 시작하지 않거나 대상에 인코딩이 필요한 ASCII 이외 문자가 있으면 운영 환경에서 발견하게 두지 않고 미리 알려 줘요.

- [Telegram — AI 텔레그램 스티커, 이모지, 채널 브랜딩](https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215)

## 플랫폼 소개

**Telegram — AI 텔레그램 스티커, 이모지, 채널 브랜딩** — 앱 개발: AiToolsForApps. 이용 가능 위치:: https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215/f/telegram-markdownv2-escape-bot-api

### 다른 언어

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