助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈

Markdown

更新于: 2026-06-24 15:44:40

Markdown 组件用于渲染 Markdown 格式的文本。

属性设置

Markdown 组件提供了丰富的属性配置选项,以下是一些关键属性配置说明。关于组件尺寸、位置、样式、指针、变换等通用属性的设置方法,请参考设置组件属性和事件

常用语法

常用的 Markdown 语法及示例如下表所示。

元素

语法

效果图

标题

# 一级标题
## 二级标题
### 三级标题

Image

加粗文本

**加粗文本**

Image

斜体文本

*斜体文本*

Image

有序列表

1. 有序列表项一
2. 有序列表项二

Image

无序列表

- 无序列表项一
- 无序列表项二

Image

引用

> 这是一个引用。

Image

链接

单击[链接](https://www.coze.cn/docs/guides/webview)

Image

图片

![这是一个图片](https://lf-coze-web-cdn.coze.cn/obj/coze-web-cn/flow/bot-studio/app-builder/example-cn.png)

Image

视频

Markdown 本身不支持插入视频,通常需借助 HTML 标签来实现。示例如下:

<video width="640" height="360" controls>
  <source src="https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/437e76ca80cc4b408a4003e13d5ac964" type="video/mp4">
</video>

Image

音频

Markdown 本身不支持插入音频,通常需借助 HTML 标签来实现。示例如下:

<audio controls>
  <source src="path/to/your/audio.mp3" type="audio/mpeg">
</audio>

Image

绑定数据

Markdown 组件支持引用工作流的返回数据、组件内容、局部上下文、系统变量、界面变量等变量内容。你可以通过引用变量为 Markdown 组件绑定动态数据。详情请参见设置组件内容参数
例如创建一个搜索图片的工作流,将该工作流的搜索结果(图片 URL),绑定到 Markdown 组件的图片元素中,并为 Markdown 组件配置一个事件,当 Markdown 组件加载时,自动触发工作流的调用,从而实现动态更新组件内容。

绑定数据
Image

配置事件
Image

展示效果
Image

设置元素对齐方式

你可以通过 Markdown 组件属性中的水平对齐垂直对齐配置项,一键调整 Markdown 元素的对齐方式。
Image

设置文本颜色

你可以通过 Markdown 组件属性中的颜色配置项,设置 Markdown 组件中纯文本元素的显示颜色。
Image

设置最大行数

你可以通过 Markdown 组件属性中的最大行数配置项,配置 Markdown 组件中标题和正文元素的最大显示行数,超过最大行数后显示为 ...
Image

配置指针

配置鼠标在指定组件区域内的指针样式。
你可以选择根据元素类型自动显示,也可以指定某一特定的指针样式。

属性配置项
Image

效果图
Image

添加边框和阴影效果

你可以通过 Markdown 组件属性中的圆角边框阴影等配置项,设置 Markdown 组件添加边框及阴影效果。
Image

隐藏组件

Markdown 组件的可见性可通过设置常用条件或表达式灵活控制,以实现特定场景下的隐藏或显示。

  • 表达式方式
    • 设置为 false:显示组件。
    • 设置为 true:隐藏组件。
    • 设置为变量:通过变量值(true 或 false)动态控制组件的可见性。配置示例,请参考隐藏组件
  • 常用条件方式
    支持通过可视化界面设置条件,以控制组件的可见性。配置示例,请参考隐藏组件

事件设置

通过配置 Markdown 组件的事件,可以为 Markdown 组件添加丰富的交互功能,以增强用户体验和界面的互动性。

事件项

说明

事件类型

当 Markdown 组件完成加载时触发事件。

组件方法

支持以下方法:

  • 清除:清除组件的内容,例如 Markdown 组件中的文字。
  • 滚动到视图:将组件滚动到可视区域内。
  • 设置内容:为组件设置或更新内容。
  • 复制到剪切板:复制文本内容到剪切板。