QQ机器人文档-Markdown 消息

来源于腾讯QQ机器人文档

目前需要内邀开通 当开通模版 MD 或原生 MD 后,主动 MD 默认生效,被动 MD 仍需单独申请开通。

单聊

群聊

文字子频道

频道私信

机器人接收

-

-

-

-

机器人发送

支持

支持

支持

支持

#支持格式

#标题

# 一号标题
## 二号标题
正文

#文字样式

**加粗**
__下划线加粗__
_斜体_
*星号斜体*
***加粗斜体***
~~删除线~~

#链接

欢迎来到:\uD83D\uDD17腾讯网
文档可以访问<https://doc.qq.com>

#图片

对于 markdown 消息内的图片资源,QQ 后台为了保护用户 IP 隐私的原因,会通过域名代理和内容缓存机制解析到 QQ 客户端,但不会持久化存储,请开发者自身维护图片 url 的可用性,当 url 不可用时,markdown 消息内的图片可能不能正常渲染展示。

text #208px #320px

#有序列表

# 有序列表

  1. 新人降落桃源岛的欢迎仪式
  2. 阳光准则助力建设有温度的频道
  3. 岛民分享吹水纳凉

#无序列表

# 无序列表

  • 新人降落桃源岛的欢迎仪式
  • 阳光准则助力建设有温度的频道
  • 岛民分享吹水纳凉

#列表嵌套

# 有序列表标题

  1. 嵌套一层
    • 列表前是普通文本,则需要在列表前用空行隔开,否则无法识别
    • 如果是段落标签比如标题,则无需用空行隔开
  2. 嵌套二层
    1. 我是有序列表,二级列表前面需要空4个空格
    2. 无序列表和有序列表可以相互嵌套,但是不建议无限制嵌套。

#块引用

> 青青子衿,悠悠我心,但为君故,沉吟至今
> 四月维夏,六月徂暑。先祖匪人,胡宁忍予
> 秋日凄凄,百卉具腓。乱离瘼矣,爰其适归?
诗经《小雅》

#水平分割线

这是段落1




这是段落2

#换多行

第一行

第二行

\u200B
\u200B
第三行

#发送方式

自定义 markdown 消息: 【内邀使用】

{
"markdown": {
"content": "# 标题 \

简介很开心 \

内容\uD83D\uDD17腾讯"
}
}

消息模版:QQ Bot 提供 markdown 消息模版能力。

// 模版例子

#{{.title}}

img#618px #249px

*{{.para1}}
*{{.para2}}

{{.desc}}

{{.content}}[{{.link_introduction}}]({{.link}})

// 发送case
{
\t"markdown": {
\t\t"custom_template_id": "101993071_1658748972",
\t\t"params": [{
\t\t\t\t"key": "title",
\t\t\t\t"values": ["标题"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "image",
\t\t\t\t"values": [
\t\t\t\t\t"https://resource5-1255303497.cos.ap-guangzhou.myqcloud.com/abcmouse_word_watch/other/mkd_img.png"
\t\t\t\t]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "para1",
\t\t\t\t"values": ["段落1"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "para2",
\t\t\t\t"values": ["段落2"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "desc",
\t\t\t\t"values": ["简介"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "content",
\t\t\t\t"values": ["在这个子频道非常开心"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "link_introduction",
\t\t\t\t"values": ["链接介绍"]
\t\t\t},
\t\t\t{
\t\t\t\t"key": "link",
\t\t\t\t"values": ["https://www.qq.com"]
\t\t\t}
\t\t]
\t}
}

#数据结构与协议

消息发送 markdown 字段值是一个 json object,具体字段如下:

属性

类型

必填

说明

content

string

原生 markdown 文本内容

custom_template_id

string

markdown 模版id,申请模版后获得

params

Array

{key: xxx, values: xxx},模版内变量与填充值的kv映射