# Telegram MarkdownV2 跳脫工具 | 告別 can't parse entities

> 線上免費跳脫 Telegram Bot API 的 MarkdownV2 的 18 個保留字元。兩種模式，保護連結與程式碼，提醒未關閉的實體，並提供可用於 cURL、aiogram 或 grammY 的程式碼。

- **來源 (source):** https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215/f/tiaotuo-markdownv2-telegram-bot-api
- **平台 (platform):** AiToolsForApps
- **語言 (language):** zh

## 重點摘要

- 在 Telegram 中跳脫 MarkdownV2，訊息才不會出錯
- 貼上你的文字，就能得到可直接用於 parse_mode: MarkdownV2 的跳脫版本，18 個保留字元都已處理，新增的反斜線會醒目標示。免費、在你的瀏覽器中運作，不需帳號。
- 18 個保留字元，與規格所述完全一致：_ * [ ] ( ) ~ ` > # + - = | { } . !，沒有漏掉句號和驚嘆號，因為它們才是最常讓訊息出錯的字元。
- 真正的兩種模式，而不是一種：「原樣」讓你的文字就是文字，「保留格式」則保留粗體、斜體、底線、刪除線、劇透和引用，並跳脫其他所有內容。
- 依情境跳脫，而不是暴力處理：行內程式碼和 ``` 區塊只會套用規格要求的跳脫，連結則會跳脫顯示的文字而不跳脫網址，所以你的連結仍然有效。

## 在 Telegram 中跳脫 MarkdownV2，訊息才不會出錯

MarkdownV2 跳脫工具會拿你要透過 Bot API 傳送的文字，回傳同一段文字，並已為 `parse_mode: "MarkdownV2"` 做好準備。它會跳脫 Telegram 宣告為保留的十八個字元：_ * [ ] ( ) ~ ` > # + - = | { } . !，並以不同顏色顯示它所新增的每一個反斜線，讓你清楚看到它動了哪裡，以及為什麼。

它有兩種模式，因為跳脫並不總是代表同一件事。在「原樣」模式下，你所有的文字都只是文字：任何星號或底線都不會被解讀為格式，所以你輸入什麼，讀到的就是什麼。在「保留格式」模式下，你刻意加上的標記（粗體、斜體、底線、刪除線、劇透以及行首的引用）會被保留，其他所有內容則被跳脫。你開啟但沒有關閉的標記不會被放過：它會變成一般字元，並提醒你。

這個跳脫工具與正規表示式取代的差別，在於它理解情境。在 `行內程式碼` 和 ``` 區塊中，只會跳脫反引號和反斜線，這正是規格所要求的。在 `[文字](網址)` 連結中，顯示的文字會跳脫，目標網址則不跳脫（右圓括號和反斜線除外）：這樣你的網址就能完整送達，而不是被塞滿反斜線而失效。它也能辨識自訂表情符號 `![x](tg://emoji?id=…)` 並讓它們原封不動通過。

而在訊息送出之前，它還會檢查。它會偵測開啟後未關閉的實體，並告訴你是哪一個（粗體、斜體、程式碼、區塊、方括號），還附有一鍵關閉或跳脫的按鈕。如果連結不是以 https:// 或 tg:// 開頭，目標網址含有你應該編碼的非 ASCII 字元，文字原本就帶有反斜線而你即將重複跳脫，或超過 Telegram 會截斷的 4096 個字元，它都會提醒你。下方是用真實的 Telegram 對話氣泡呈現的預覽（透過讀取跳脫後的文字建構而成），以及已為 cURL、原始 Bot API、python-telegram-bot、aiogram、telegraf 或 grammY 組好的程式碼片段。

## 包含內容

- 18 個保留字元，與規格所述完全一致：_ * [ ] ( ) ~ ` > # + - = | { } . !，沒有漏掉句號和驚嘆號，因為它們才是最常讓訊息出錯的字元。
- 真正的兩種模式，而不是一種：「原樣」讓你的文字就是文字，「保留格式」則保留粗體、斜體、底線、刪除線、劇透和引用，並跳脫其他所有內容。
- 依情境跳脫，而不是暴力處理：行內程式碼和 ``` 區塊只會套用規格要求的跳脫，連結則會跳脫顯示的文字而不跳脫網址，所以你的連結仍然有效。
- 你看得到改了什麼：每個新增的反斜線都會在原文上醒目標示，被視為連結或程式碼的區段也會另外標記。不必盲目相信一個黑盒子。
- **在 Bot API 回傳 400 之前就先提醒：未關閉的實體（並指出名稱）、落單的括號、孤立的反引號、缺少 https** — // 的連結、含有非 ASCII 字元的網址、已跳脫過的文字，以及超過 4096 個字元的訊息。
- 一鍵修正：每則提醒都附有按鈕，可關閉實體、跳脫字元，或移除文字原本就帶有的反斜線，並且會立即對結果重新計算跳脫。
- 在真實的 Telegram 對話氣泡中預覽：跳脫後的文字會重新解析，並以你的使用者將看到的樣子繪製，提供淺色與深色主題，在傳送任何內容之前先看一眼。
- 還有組好的程式碼：複製可直接使用的片段，支援 cURL、原始 Bot API、python-telegram-bot、aiogram、telegraf 或 grammY，並以 Token 佔位符取代真實認證資料。我們絕不會向你索取機器人的 Token。

## 常見問題

### 傳送 MarkdownV2 訊息時，為什麼會出現 can't parse entities 錯誤？

因為文字中含有 MarkdownV2 視為保留字元、而前面沒有反斜線的 18 個字元之一：_ * [ ] ( ) ~ ` > # + - = | { } . ! Telegram 會嘗試把它們解讀為格式標記，找不到預期的結尾，就會以 400 錯誤「can't parse entities」拒絕訊息。最常出問題的是句尾的句號、清單的連字號和括號，正因為沒有人會把它們和格式聯想在一起。MarkdownV2 跳脫工具會掃過你的文字，在需要的地方加上反斜線，並把每一個都醒目標示，讓你看到動了哪裡，而且如果讓訊息出錯的是一個開啟後未關閉的實體，而不是單一字元，也會提醒你。

### Telegram 的 MarkdownV2 需要跳脫哪些字元？

共有十八個：底線（_）、星號（*）、方括號（[ 和 ]）、圓括號（( 和 )）、波浪號（~）、反引號（`）、大於符號（>）、井字號（#）、加號（+）、連字號（-）、等號（=）、直線（|）、大括號（{ 和 }）、句號（.）和驚嘆號（!）。在程式碼區塊或行內程式碼片段中規則會不同：那裡只需要跳脫反引號和反斜線。而在連結 [文字](網址) 中，顯示的文字需要跳脫，但目標網址只需要跳脫右圓括號和反斜線：如果你把整個網址都跳脫，連結就會失效。這個 App 會在各自對應的區段套用這三條規則。

### 可以在跳脫文字時，保留我刻意加上的粗體和斜體嗎？

可以，這就是「保留格式」模式的用途。在這個模式下，跳脫工具會區分你刻意加上的標記，也就是 *粗體*、_斜體_、__底線__、~刪除線~、||劇透|| 以及行首的引用 >，和其餘文字，只跳脫後者。如果開啟標記後面找不到結尾，它不會就這樣懸著：它會變成一般字元，並且你會收到一則提醒，指出受影響的實體名稱，還有一個關閉它的按鈕。如果你想要的相反，也就是完全不要把任何內容解讀為格式，請使用「原樣」模式：18 個保留字元會全部被跳脫，你輸入什麼，讀到的就是什麼。

### 使用跳脫工具需要註冊，或提供機器人的 Token 嗎？

兩者都不需要。跳脫、未關閉實體的偵測、預覽和程式碼片段都完全在你的瀏覽器中計算：你可以不建立帳號、不限次數、免費使用。App 也絕不會要求你機器人的 Token，或代表你向 Bot API 傳送任何東西：你複製的程式碼片段帶有 <TU_TOKEN> 和 <CHAT_ID> 這類佔位符，由你在自己的環境中填入。只有儲存附有文字和按鈕的訊息以便日後重複使用時，才需要免費帳號。

### 跳脫工具會破壞我訊息中的連結或程式碼嗎？

不會，因為它不是盲目地取代字元：它會先依情境把文字切分，再進行跳脫。它能辨識 [文字](https://…) 連結、反引號之間的行內程式碼、帶有語言標籤的 ``` 區塊，以及自訂表情符號 ![x](tg://emoji?id=…)，並對每個區段套用相應的規則。實際上這代表你的網址會完整送達，你的程式碼片段不會被反斜線塞滿，區塊的語言標籤也會保留。此外，如果連結不是以 https:// 或 tg:// 開頭，或目標網址含有應該編碼的非 ASCII 字元，它會提醒你，而不是讓你在正式環境中才發現。

- [Telegram — 以 AI 製作 Telegram 頻道的貼圖、表情符號與品牌形象](https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215)

## 關於平台

**Telegram — 以 AI 製作 Telegram 頻道的貼圖、表情符號與品牌形象** — 應用程式，來自 AiToolsForApps. 可在以下網址使用: https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215/f/tiaotuo-markdownv2-telegram-bot-api

### 其他語言

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