Telegram Developer Tools

Telegram 消息排版
从未如此优雅、精准。

完美解决 MarkdownV2 特殊字符报错，实时渲染预览。专为 Telegram 频道主与 Bot 开发者打造的高级生产力工具。

⚠️ 注意：此源码专门发给机器人接口 (Bot API) 或频道管理 Bot 解析使用，普通用户勿在个人聊天框内直接粘贴。

实时排版预览
已自动渲染
在此输入文案…

👆 此处为最终在手机端呈现的 1:1 真实排版效果

底层解析规则速查

深入了解 Telegram Bot API 的两种核心格式化语言机制，即使脱离工具，也能写出完全符合官方规范的底层源码。

MarkdownV2 核心语法

相较于传统 Markdown，Telegram V2 版本的排版符号有着严格对应关系。

加粗 (Bold)*粗体文字*
斜体 (Italic)_斜体文字_
下划线 (Underline)__下划线__
删除线 (Strikethrough)~删除线~
剧透隐藏 (Spoiler)||隐藏文字||
行内代码 (Code)`行内代码`
超链接 (Inline Link)[链接文字](网址)
⚠️

字符转义雷区

不在格式化符号内的以下 18 个保留字符，必须使用反斜杠转义！

_ * [ ] ( ) ~ ` > # + – = | { } . !
排版器已内置自动转义引擎，你可以直接忽略此规则。

HTML 解析模式支持

容错率最高的解析模式，支持以下精简版的原生 HTML 标签。

  • <b><strong>
    加粗 (Bold)
  • <i><em>
    斜体 (Italic)
  • <u><ins>
    下划线 (Underline)
  • <s><del>
    删除线 (Strikethrough)
  • <tg-spoiler>
    剧透隐藏 (Spoiler)
  • <a href="...">
    网页超链接 (Link)
  • <code>
    行内代码 (Inline Code)
  • <pre>
    多行代码块 (Pre)

工具应用场景与最佳实践

不论你是运营万人的大频道，还是开发全自动的电报机器人，我们的排版器都能帮你省下大量排错时间，让生产力产生质的飞跃。

🤖

Bot API 全自动消息推送

开发者在调用 sendMessage 接口时，将 parse_mode 设置为 MarkdownV2，并直接传入我们生成的底层源码。

Python (aiogram / telebot) 
bot.send_message(
    chat_id=123456789,
    text="*加粗文字*\n欢迎访问 \[OneTelegram\]\(https://...\)",
    parse_mode="MarkdownV2"
)
📢

大型频道运营与图文广播

使用 Telegram 原生客户端发送图文广播时，通过此工具能实现原生应用中很难徒手打出的“复杂隐秘排版”。

  • ✅ 所见即所得：彻底告别在客户端里手抖发错排版的尴尬，发文前可反复微调。
  • ✅ 富文本混排：无缝支持 Emoji 穿插，绝不会因为特殊符号导致格式断层。
  • ✅ 突破客户端限制：轻松写出带超链接的斜体、删除线等原生极难输入的组合。

防报错最佳实践指南

Telegram API 最臭名昭著的 Bad Request 报错，往往是因为标签未闭合或未转义。为了保证生产环境 100% 稳定，请遵循以下原则：

  • 🔥 永远使用本工具转义：不要轻信简单的正则替换，URL 内部的 ) 或 \ 未被处理是 99% 导致服务器拒收消息的元凶。
  • 🛡️ 优先选择 HTML 模式：如果文案中包含大量不可控的用户动态输入（如不规则的用户名），强烈建议切换为 HTML 模式，其系统容错率极高。
  • ⚠️ 警惕嵌套限制：不要尝试将代码块 ``` 嵌套在加粗标签 * 内部，Telegram 引擎在底层不支持这种魔幻嵌套，会导致渲染失败。
400 Bad Request
{“ok”:false,”error_code”:400,”description”:”Bad Request: can’t parse entities: Character ‘_’ is reserved and must be escaped with the preceding ‘\\'”}
🛡️ 已被排版器成功拦截并自动修复

常见问题与排错指南

汇总了开发者与频道主在使用 Telegram 格式化文本时最常遇到的核心痛点，帮你迅速避坑。

这是 Telegram 开发中最常见的错误。绝大多数情况是因为你使用了系统的保留字符（例如 _、*、[、(、~、+ 等），但没有对其进行正确的反斜杠转义。使用本排版器进行文字高亮，我们的底层转义引擎会自动为你屏蔽这些雷区。
如果你的文案包含不可控的“用户动态输入”（例如抓取他人的用户名、商品名称等），强烈建议使用 HTML 模式。因为 HTML 依靠 <> 闭合标签，容错率极高，绝对不会因为用户的名字里多带了一个下划线 _ 就导致你的 Bot 崩溃拒发消息。
Telegram 的底层渲染引擎有着极其严格的嵌套限制。大多数格式之间不能随意组合，尤其是 代码块（Code）和剧透隐藏（Spoiler）不能与其他强调标签相互嵌套。我们在本工具中生成的语法都是符合单一强调原则的，建议不要人为制造“魔幻嵌套”。
注意：此工具生成的“底层源码”是专门供 Telegram Bot API 开发接口 调用的。如果你是个人用户想在手机上直接发消息，并不需要复制源码，手机端只需要长按文字选择“格式化（Format）”功能即可。
仿站神器