飞书智能伙伴Aily之Markdown语法使用说明

飞书智能伙伴Aily之Markdown语法使用说明

智能伙伴Aily手册精选NaN-NaN-NaN
产品功能
备用回复、消息节点支持 Markdown 语法及其扩展能力,开发者可以发送超链接、图片、表格、图表等富文本消息。
支持的 Markdown 语法
基础语法
效果
Markdown 语法
加粗
斜体
删除线
250px|700px|reset
语法:
**这是一行加粗的文本**
*这是一行斜体文本*
~~这是一行删除线文本~~
***~~混合所有样式的文本~~***
链接
250px|700px|reset
image.png
语法:
[这是一个链接](https://www.feishu.cn)
图片
250px|700px|reset
image.png
语法:
![hover_text](https://image.url)
说明:
  • 飞书渠道支持直接写 img_key
示例:
<font color="grey">这是一张动态图片</font>
<font color="grey">这是一张静态图片</font>
标题
250px|700px|reset
image.png
语法:
# 一级标题
## 二级标题
限制说明:
  • 只支持一级标题和二级标题
分割线
250px|700px|reset
image.png
语法:
---
说明:
  • 在 --- 前面要加一个换行
示例:
**Welcome to Aily!**
We hope you have a great experience here.
---
无序列表
250px|700px|reset
image.png
语法:
- item1
- item2
限制说明:
  • 暂时不支持缩进
  • 内容暂时只支持文本 / 链接类型
有序列表
250px|700px|reset
image.png
语法:
```
{"x": "hello", "y": "world"}
```
限制说明:
  • 暂时不支持缩进
  • 内容暂时只支持文本 / 链接类型
代码
250px|700px|reset
image.png
语法:
```
{"x": "hello", "y": "world"}
```
限制说明:
  • 通过 ```[langMark] 指定语法,如 ```js 或 ```go
  • ⚠️ 仅飞书客户端 7.6+ 支持
高级组件
组件名称
Markdown 语法
@
250px|700px|reset
image.png
语法:
<at id='all'></at>
<at id='{aily_user_id}'></at>
<at email='{user_email}'></at>
ID 说明:
  • id='all' 为 at 所有人
错误情况说明 ⚠️ :
  • 如果 id 填写错误的话,卡片上展示:
250px|700px|reset
image.png
  • 如果 email 填写错误的话(如查无此用户),卡片报错
250px|700px|reset
image.png
颜色
250px|700px|reset
image.png
语法:
<font color='red'> 内容 </font>
颜色说明:
表格
250px|700px|reset
image.png
语法:
<table columns={columns} data={data}/>
参数说明:
飞书消息卡片限制请注意 ⚠️ :
  1. columns 数量最多 10 个,超出列无法展示
  1. 一张卡片最多 5 个 Table,超出的表格以文本方式展示
图表
250px|700px|reset
image.png
250px|700px|reset
image.png
250px|700px|reset
image.png
250px|700px|reset
image.png
250px|700px|reset
image.png
250px|700px|reset
image.png
语法:
<chart chartSpec={spec} />
参数说明:
分栏
250px|700px|reset
image.png
语法:
<row>
<col flex=1> 内容1 </col>
<col flex=2> 内容2 </col>
</row>
参数说明:
  • 通过 flex 属性控制宽度比例
记录详情
250px|700px|reset
image.png
语法:
<record fields={fields} data={data} />
参数说明:
辅助文本
250px|700px|reset
image.png
语法:
<note> 辅助文本 </note>
高亮块
250px|700px|reset
image.png
语法:
<highlight> 高亮内容 </highlight>
参数说明:
  • 高亮块内支持多行文本,如下:
<highlight>
内容1
内容2
</highlight>
  • 多行文本时请不要与开始标签(<highlight>)或关闭标签(</highlight>)在同一行
飞书消息卡片限制说明 ⚠️ :
  • 目前只支持灰色
按钮
250px|700px|reset
image.png
语法:
<button
type="primary"
width="default"
action="navigate"
>
跳转到飞书官网
</button>
<button
type="primary"
width="default"
action="message"
message="新消息是什么"
skill="技能 id"
>
点击使用技能
</button>
参数说明:
飞书卡片标题
250px|700px|reset
image.png
语法:
<title style="blue">标题内容</title>
参数说明:
卡片报错及常见原因
卡片错误提示
错误释义
⚠️ Missing open tag for corresponding close tag.
错误原因:
  • 在没有对应的起始标签时、就遇到了闭合标签;例如只写了 </button> (没有写 <button>)
⚠️ Attributes should not be written within close tags.
错误原因:
  • 在闭合标签中书写属性;例如 <button>Click</button message="aaa">
⚠️ Incorrect usage of self-closing syntax within close tags.
错误原因:
  • 在闭合标签里使用了自关闭的语法;例如 </button /> 的错误写法
⚠️ Mismatch between open and close tags.
错误原因:
  • 起始标签和闭合标签对不上;例如 <row><col></row>(中间漏写了 </col>)
  • 或存在缺少了配对闭合标签的起始标签;例如只写了 <button>Click
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
联系我们立即试用