Telegram MarkdownV2 与 HTML 转义工具
粘贴任意文本,即可得到适用于 Telegram MarkdownV2 或 HTML parse_mode 的转义结果,让 sendMessage 不再报错 Bad Request: can't parse entities。
MarkdownV2 要求用反斜杠转义 _ * [ ] ( ) ~ ` > # + - = | { } . !;在 code 和 pre 内只需转义 ` 和 \;在链接的 (…) 内只需转义 ) 和 \。HTML 要求转义 < > &。
测试一下:发送到聊天
Token 只保存在你的浏览器中(localStorage),并且只发送到 api.telegram.org。
如何为 Telegram 机器人转义 Markdown
- 粘贴原始文本——用户名、价格、一行日志等。不要粘贴你自己的格式标记:先转义数据,再自己用
*bold*或<b>包起来。 - 选择模式:MarkdownV2 普通文本、MarkdownV2
code/pre内、MarkdownV2 链接的 (…) 内,或者 HTML。结果会随输入实时更新。 - 点击复制,或者点击复制为 JSON 字符串,得到加上引号、反斜杠已加倍的值,可直接用于 JSON 请求体或源代码。
- 可选:打开测试一下,输入 Bot Token 和
chat_id,用sendMessage和对应的parse_mode发送结果。code 模式下文本会被反引号包裹,链接模式下它会成为[link](…)的 URL。
Telegram MarkdownV2 转义规则
规则来自 Bot API 格式化选项:
- 普通文本中,以下字符前必须加
\:_ * [ ] ( ) ~ ` > # + - = | { } . !。工具还会转义反斜杠本身。 - 在
pre和code实体内,只转义`和\。 - 在内联链接或自定义表情定义的 (…) 部分内,只转义
)和\。
示例:Price: 5.99 (incl. tax) - order #42! 会变成:
Price: 5\.99 \(incl\. tax\) \- order \#42\!
点号和感叹号是最常见的坑:漏掉一个,整个请求就会失败。
Telegram HTML parse_mode
HTML 模式下,所有不属于标签或实体的 <、> 和 & 都必须写成 <、> 和 &。工具只替换这三个字符。正因为规则如此简单,对于动态文本,HTML 往往是更稳妥的选择。支持的标签列表见 /zh/guides/telegram-bot-send-message.html。
隐私
转义完全在浏览器中完成,不会发出任何请求。只有可选的测试功能会发送一次 sendMessage 请求,直接从浏览器发到 api.telegram.org;Token 保存在 localStorage 中,绝不会到达我们的服务器。你也可以在 /zh/telegram-bot-api-tester.html#sendMessage 中构建请求。其他错误信息的解释见 /zh/guides/telegram-bot-api-errors.html。
常见问题
Telegram MarkdownV2 中哪些字符需要转义?
普通文本中:_ * [ ] ( ) ~ ` > # + - = | { } . !,每个字符前都要加反斜杠(反斜杠本身也要转义)。在 code 和 pre 内只需转义 ` 和 \;在链接的 (…) 内只需转义 ) 和 \。
为什么 sendMessage 报错“can't parse entities”?
文本中有未转义的保留字符,或者有未闭合的实体。Telegram 的错误信息通常会指出是哪个字符。请对文本中的动态部分进行转义,只让你自己的格式标记保持不转义。
应该用 MarkdownV2 还是 HTML?
对于来自用户或数据库的文本,HTML 通常更简单:只需替换 <、> 和 &。MarkdownV2 则需要转义 18 个字符。
代码块里的文本需要转义吗?
在 MarkdownV2 中,code 和 pre 内只需转义 ` 和 \,请在工具中选择对应的模式。HTML 模式下与其他地方一样,转义那三个字符即可。
其他工具
Chat ID 查询工具Mini App initData 校验工具Webhook 检查工具Bot API Tester