# 发送Markdown文档

黑盒语音是支持发送Markdown文档的,消息type=4或者10的时候则为markdown形式的文档

# Markdown 的特点
1. **简洁明了**：Markdown 语法简单易懂，易于学习和使用，能够让消息编写更加高效。
2. **可读性高**：Markdown 文档以纯文本形式呈现，无需复杂的排版和样式，使得消息更加易读。

# 基础语法及展示
## 标题
用#号定义标题，#号数量代表标题层级。目前仅支持2级标题,更多的#是不起作用的

请求示例：
```
{
    "msg": "# 一级标题\n\n## 二级标题\n\n### 三级标题\n\n#### 四级标题\n\n##### 五级标题\n\n###### 六级标题",
    "msg_type": 4,
    "heychat_ack_id": "0",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034",
}
```
示意图:
![](https://imgheybox.max-c.com/oa/2024/10/22/048a9a80c82568e42d751965d2b858eb.png)
## 文本
`
支持大多数标记格式。通过在文本前后添加 “**” 实现粗体，添加 “*” 实现倾斜，添加 “~~” 实现删除线的格式。还支持上标<sup>上标格式文本</sup>和下标<sub>下标格式文本</sub>。此外，还可以添加链接，如[黑盒语音官网](https://chat.xiaoheihe.cn/home/index)
`
请求示例：
```
{
    "msg": "**粗体文本内容**\n\n *斜体文本内容*\n\n ~~这是一段被删除的文字~~\n\n正常文本 <sup>上标格式文本</sup> \n\n正常文本 <sub>下标格式文本</sub> \n\n[黑盒语音官网](https://chat.xiaoheihe.cn/home/index)",
    "msg_type": 4,
    "heychat_ack_id": "0",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034"
}
```
示意图:
![](https://imgheybox.max-c.com/oa/2024/10/22/e135699eec658f1eceb93fcef01088fe.png)
## 图片
### 在Markdown中嵌入图片
按照 `
![xxx](path)
`的格式来插入图片。
请求示例：
```
{
    "msg": "![lol](https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg)",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034",
    "channel_type": 1
}
```
示意图：
![](https://imgheybox.max-c.com/oa/2024/10/22/18acb98246e33745351128a882ad1a69.png)
### 指定图片尺寸
请求示例：
```
{
    "msg": "![lol](https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg)",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034",
}
```
示意图：
![](https://imgheybox.max-c.com/oa/2024/10/22/e684e2959b84abfd1fbe310cd5022308.png)

## 列表
### 有序列表
使用数字加 “.” 的方式创建有序列表。
请求示例：
```
{
    "msg": "1.  A\n\n  2.  B\n\n  3.  C\n\n  4.  D",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034"
}
```
示意图：
![](https://imgheybox.max-c.com/oa/2024/11/05/48dd5ee73717ebf6981cedf91dfdc3d3.png)
### 无序列表
请求示例：
使用 “* ” 创建无序列表。
```
{
    "msg": "* 这是\n\n* 无序\n\n* 列表",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034"
}
```
示意图：
![](https://imgheybox.max-c.com/oa/2024/10/24/05c943581d54efd04f9ea6809d54195b.png)