# Telegram MarkdownV2 エスケープ|can't parse entities を解消

> Telegram Bot API 用に、MarkdownV2 の予約済み 18 文字を、オンラインで無料でエスケープ。2つのモード、リンクとコードの保護、閉じられていないエンティティの警告、cURL、aiogram、grammY 向けのコード付き。

- **ソース (source):** https://ae.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-markdownv2-escape-bot-api
- **プラットフォーム (platform):** AiToolsForApps
- **言語 (language):** ja

## 概要

- メッセージを壊さずに、Telegram の MarkdownV2 をエスケープ
- テキストを貼り付けると、parse_mode: MarkdownV2 にそのまま使えるエスケープ済みのバージョンが得られます。予約された 18 文字が処理され、追加されたバックスラッシュがハイライトされます。無料で、ブラウザ上で動作し、アカウントは不要です。
- 仕様どおりの、予約された 18 文字すべて
- 1つではなく、本当の2つのモード
- 力任せではなく、文脈ごとにエスケープ

## メッセージを壊さずに、Telegram の MarkdownV2 をエスケープ

Telegram の MarkdownV2 エスケープツールは、Bot API で送信するテキストを受け取り、`parse_mode: "MarkdownV2"` に対応した形で、同じテキストを返します。Telegram が予約済みと定めている 18 文字(_ * [ ] ( ) ~ ` > # + - = | { } . !)をエスケープし、追加した各バックスラッシュを別の色で表示するので、何に、なぜ手を加えたのかが正確に分かります。

モードは2つあります。エスケープは、いつも同じ意味とは限らないからです。「リテラル」モードでは、テキスト全体がテキストとして扱われます。アスタリスクやアンダースコアが書式として解釈されることはなく、入力したものがそのまま表示されます。「書式あり」モードでは、意図して付けた印(太字、斜体、下線、取り消し線、スポイラー、行頭の引用)は残され、それ以外はすべてエスケープされます。開いたまま閉じていない印は紛れ込まず、リテラル文字に変換され、警告が出ます。

このエスケープツールが、正規表現による単純な置換と違うのは、文脈を理解している点です。`インラインコード` と ``` ブロックの中では、仕様のとおり、バッククォートとバックスラッシュだけがエスケープされます。リンク `[テキスト](url)` では、表示テキストはエスケープされ、リンク先は(閉じ丸括弧とバックスラッシュを除いて)されないので、URL はバックスラッシュだらけにならず、壊れることなく届きます。カスタム絵文字 `![x](tg://emoji?id=…)` も認識し、そのまま通します。

そして、メッセージが送信される前に、確認します。開いたまま閉じられていないエンティティ(太字、斜体、コード、ブロック、角括弧のどれか)を検出して、それが何かをお知らせし、ワンクリックで閉じたりエスケープしたりできるボタンも付きます。リンクが https:// や tg:// で始まっていない場合、リンク先にエンコードすべき非 ASCII 文字がある場合、テキストにすでにバックスラッシュが入っていて二重にエスケープしようとしている場合、Telegram が切り捨てる 4096 文字を超えている場合も警告します。その下には、エスケープ済みのテキストを読み取って作った、本物の Telegram の吹き出しでのプレビューと、cURL、生の Bot API、python-telegram-bot、aiogram、telegraf、grammY 向けに組み込み済みのコードスニペットがあります。

## 含まれる機能

- **仕様どおりの、予約された 18 文字すべて** — _ * [ ] ( ) ~ ` > # + - = | { } . ! ピリオドと感嘆符も忘れません。メッセージを最も壊しやすい文字です。
- **1つではなく、本当の2つのモード** — 「リテラル」はテキストをそのままテキストとして扱い、「書式あり」は太字、斜体、下線、取り消し線、スポイラー、引用を残して、それ以外をすべてエスケープします。
- **力任せではなく、文脈ごとにエスケープ** — インラインコードと ``` ブロックには、仕様が求めるエスケープだけが適用され、リンクでは表示テキストはエスケープされますが 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 はそれらを書式の印として解釈しようとし、期待する終わりの印が見つからず、「can't parse entities」 という 400 エラーでメッセージを拒否します。最もよくある原因は、文末のピリオド、リストのハイフン、括弧です。誰も書式と結びつけて考えないからです。Telegram の MarkdownV2 エスケープツールは、テキストを走査して必要な場所にバックスラッシュを追加し、触れた箇所が分かるよう、それぞれをハイライトします。また、メッセージを壊しているのが、単独の文字ではなく、開いたまま閉じられていないエンティティである場合も、お知らせします。

### Telegram の MarkdownV2 では、どの文字をエスケープする必要がありますか?

全部で 18 文字です。アンダースコア(_)、アスタリスク(*)、角括弧([ と ])、丸括弧(( と ))、チルダ(~)、バッククォート(`)、不等号の「より大きい」(>)、シャープ(#)、プラス(+)、ハイフン(-)、イコール(=)、縦棒(|)、波括弧({ と })、ピリオド(.)、感嘆符(!)です。コードブロックやインラインコードの内部では、ルールが変わります。そこでは、バッククォートとバックスラッシュだけをエスケープします。また、リンク [テキスト](url) では、表示テキストはエスケープしますが、リンク先では閉じ丸括弧とバックスラッシュだけをエスケープします。URL 全体をエスケープすると、動作しなくなります。このツールは、これら3つのルールを、それぞれの箇所に適用します。

### 意図して付けた太字や斜体を残したまま、エスケープできますか?

はい。そのための「書式あり」モードです。このモードでは、エスケープツールが、あなたが意図して付けた印(*太字*、_斜体_、__下線__、~取り消し線~、||スポイラー||、行頭の > による引用)と、エスケープすべきそれ以外のテキストを区別します。あとに閉じる印がない開始の印は、中途半端なままにならず、リテラル文字に変換され、該当するエンティティの名前と、閉じるためのボタン付きの警告が表示されます。逆に、何も書式として解釈されたくない場合は、「リテラル」モードを使ってください。予約済みの 18 文字がすべてエスケープされ、入力したとおりのものが、そのまま表示されます。

### エスケープツールを使うのに、登録したり、ボットのトークンを渡したりする必要はありますか?

どちらも不要です。エスケープ、閉じられていないエンティティの検出、プレビュー、コードスニペットは、すべてブラウザ上で行われます。アカウントを作らず、回数の制限もなく、無料で使えます。また、アプリがボットのトークンを求めることも、あなたに代わって Bot API に何かを送信することもありません。コピーするコードスニペットには、<TU_TOKEN> や <CHAT_ID> といったプレースホルダーが入っていて、ご自身の環境で入力します。無料アカウントが必要なのは、テキストとボタン付きのメッセージを保存して、別の日に再利用する場合だけです。

### エスケープツールで、メッセージのリンクやコードが壊れることはありますか?

いいえ。単純な文字の置き換えではなく、エスケープの前に、テキストを文脈ごとにトークン化するからです。リンク [テキスト](https://…)、バッククォートで囲んだインラインコード、言語ラベル付きの ``` ブロック、カスタム絵文字 ![x](tg://emoji?id=…) を認識し、それぞれの部分に対応するルールを適用します。実際には、URL がそのまま届き、コードスニペットがバックスラッシュだらけにならず、ブロックの言語ラベルも保たれます。さらに、リンクが https:// や tg:// で始まっていない場合や、リンク先に、エンコードした方がよい非 ASCII 文字が含まれている場合は、本番環境で気づくのではなく、お知らせします。

- [Telegram — AIでTelegramチャンネルのステッカー、絵文字、ブランディングを作成](https://ae.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215)

## プラットフォームについて

**Telegram — AIでTelegramチャンネルのステッカー、絵文字、ブランディングを作成** — のアプリ AiToolsForApps. 対応言語: https://ae.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-markdownv2-escape-bot-api

### その他の言語

- `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
- `pt`: https://ae.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-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
- `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
