Telegram Bot API

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

  1. 粘贴原始文本——用户名、价格、一行日志等。不要粘贴你自己的格式标记:先转义数据,再自己用 *bold* 或 <b> 包起来。
  2. 选择模式:MarkdownV2 普通文本、MarkdownV2 code/pre 内、MarkdownV2 链接的 (…) 内,或者 HTML。结果会随输入实时更新。
  3. 点击复制,或者点击复制为 JSON 字符串,得到加上引号、反斜杠已加倍的值,可直接用于 JSON 请求体或源代码。
  4. 可选:打开测试一下,输入 Bot Token 和 chat_id,用 sendMessage 和对应的 parse_mode 发送结果。code 模式下文本会被反引号包裹,链接模式下它会成为 [link](…) 的 URL。

Telegram MarkdownV2 转义规则

规则来自 Bot API 格式化选项:

示例:Price: 5.99 (incl. tax) - order #42! 会变成:

Price: 5\.99 \(incl\. tax\) \- order \#42\!

点号和感叹号是最常见的坑:漏掉一个,整个请求就会失败。

Telegram HTML parse_mode

HTML 模式下,所有不属于标签或实体的 <、> 和 & 都必须写成 &lt;、&gt; 和 &amp;。工具只替换这三个字符。正因为规则如此简单,对于动态文本,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