Discord Markdown

使用 Markdown 为 Discord 格式化文本,常用于消息、机器人回复、嵌入描述、论坛帖子、webhook 负载等场景。

安装

概览

{ “overview_html”: “Discord Markdown 是一种专为 Discord 平台设计的文本格式化工具,用于在消息、机器人回复、嵌入描述、论坛帖子和 webhook 负载等场景中增强内容的可读性与交互性。与标准 Markdown 不同,Discord 使用一套经过修改的子集,并加入了若干独特功能,如隐藏内容的 spoiler 标签、动态时间戳、子文本(subtext)以及服务器导航链接等。这些特性使得 Discord 的富文本表达更加丰富,但也带来了与普通 Markdown 渲染不一致的挑战。为了确保用户能够准确复制粘贴格式化后的消息,所有最终输出必须包裹在一个带有 `markdown` 语言标识的代码块中,从而保留原始语法而非渲染效果。这种呈现方式尤其关键,因为像 Claude 这样的 AI 聊天界面会直接渲染 Markdown(例如 `**粗体**` 显示为 **粗体**),若用户复制已渲染的文本,则粘贴到 Discord 时将丢失格式信息。因此,通过代码块提供原始语法是保证跨平台一致性的核心原则。”, “feature_items”: [ “支持 Discord 特有的格式化语法,包括粗体、斜体、删除线、下划线和隐藏内容(spoiler)”, “提供动态时间戳功能,自动根据用户本地时区显示相对或绝对时间”, “允许提及用户、角色、频道及内置导航链接(如服务器指南)”, “支持代码块语法高亮,兼容 JavaScript、Python、TypeScript 等多种编程语言”, “强制要求以 fenced code block 形式输出完整消息,确保用户可直接复制粘贴使用” ], “scenarios_html”: “Discord Markdown 的核心价值在于帮助开发者和内容创作者在各种 Discord 应用场景中高效生成美观且功能完整的消息。最常见的使用场景包括编写机器人自动回复,例如欢迎新成员加入服务器、发送系统通知或处理命令反馈;这些消息通常需要强调关键信息(如版本号或警告提示),并通过提及特定用户或频道引导后续操作。另一个典型用途是创建公告帖子,特别是在技术社区或开源项目中发布 SDK 更新、API 变更或活动通知时,结合代码示例和结构化标题能显著提升信息传达效率。此外,在论坛帖子撰写、Webhook 负载设计以及嵌入字段配置中也广泛依赖该语法,尤其是在嵌入描述部分,因其支持更长的文本(最多 4,096 字符)和更灵活的链接处理机制。无论是构建自动化工作流还是手动编辑重要沟通内容,掌握这套格式化规则都能极大增强用户体验与信息清晰度。” }