MarkdownV2 エスケープツール

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

テキストを貼り付けると、parse_mode: MarkdownV2 にそのまま使えるエスケープ済みのバージョンが得られます。予約された 18 文字が処理され、追加されたバックスラッシュがハイライトされます。無料で、ブラウザ上で動作し、アカウントは不要です。

400 の 「can't parse entities」 エラーは、あなたのロジックが原因ではありません。Telegram がエスケープされていると想定していた、ピリオド、ハイフン、括弧が原因です。

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 向けに組み込み済みのコードスニペットがあります。

登録不要

MarkdownV2 エスケープツールをここでお試しください

ツールを読み込んでいます…

アカウントなしで無料でご利用いただけます。結果を保存したい場合は、あとから登録できます。

保存 / 登録

MarkdownV2 エスケープツールのメリット

仕様どおりの、予約された 18 文字すべて

_ * [ ] ( ) ~ ` > # + - = | { } . ! ピリオドと感嘆符も忘れません。メッセージを最も壊しやすい文字です。

1つではなく、本当の2つのモード

「リテラル」はテキストをそのままテキストとして扱い、「書式あり」は太字、斜体、下線、取り消し線、スポイラー、引用を残して、それ以外をすべてエスケープします。

力任せではなく、文脈ごとにエスケープ

インラインコードと ``` ブロックには、仕様が求めるエスケープだけが適用され、リンクでは表示テキストはエスケープされますが URL はされないので、リンクは機能し続けます。

何が変わったかが見えます

追加されたバックスラッシュは、元のテキストの上でハイライト表示され、リンクやコードとして扱われた部分は別に示されます。ブラックボックスを盲信する必要はありません。

Bot API が 400 を返す前に警告

閉じられていないエンティティ(名前付き)、対応のない角括弧、単独のバッククォート、https:// のないリンク、非 ASCII 文字を含む URL、すでにエスケープ済みのテキスト、4096 文字を超えるメッセージを検出します。

ワンクリックで修正

各警告にボタンが付いています。エンティティを閉じる、文字をエスケープする、テキストにすでにあったバックスラッシュを取り除く、のどれかで、エスケープは結果に対して即座に再計算されます。

本物の Telegram の吹き出しでプレビュー

エスケープしたテキストを再び解釈して、ライトテーマとダークテーマで、ユーザーに見える形で表示します。何かを送信する前に確認できます。

さらに、組み込み済みのコード

cURL、生の Bot API、python-telegram-bot、aiogram、telegraf、grammY 向けにすぐ使えるスニペットをコピーできます。実際の認証情報の代わりに、トークンのプレースホルダーが入っています。ボットのトークンを求めることはありません。

テキストを貼り付けて、一発で送信しよう

計算はブラウザ上で行われます。登録不要、無料で、メッセージもボットのトークンも、どこにも送信されません。メッセージを保存して別の日に再利用するには、無料アカウントが必要です。

AIを使う機能では、回答はAIが生成したものであり、専門家の助言に代わるものではありません。