设置机器人消息的格式
重要
本文基于 v3 Bot Framework SDK。 如果要查找 SDK 的当前文档 4.6 或更高版本,请参阅 对话机器人 部分。
可以设置可选 TextFormat
属性来控制消息文本内容的呈现方式。
Microsoft Teams 支持以下格式设置选项:
TextFormat 值 | 说明 |
---|---|
纯文本 | 文本应被视为未应用任何格式的原始文本。 |
markdown | 文本应被视为 Markdown 格式,并根据需要在通道上呈现;请参阅 设置支持样式的文本内容的格式 。 |
xml | 文本是简单的 XML 标记;请参阅 设置支持样式的文本内容的格式 。 |
设置文本内容格式
Teams 支持 Markdown 和 XML (HTML) 格式标记的子集。
将会有以下限制:
- 仅文本邮件不支持表格格式设置。
有关在卡片中设置格式的信息,请参阅 Teams 卡片参考。
跨平台支持
若要确保你的格式设置在 Teams 支持的所有平台上有效,请注意,某些样式并非在所有平台上都受支持。
样式 | 仅文本邮件 | 仅限 XML () 的卡片 |
---|---|---|
bold | ✔ | ✖ |
italic | ✔ | ✔ |
标头 (级别 1-3) | ✖ | ✔ |
删除线 | ✖ | ✔ |
水平规则 | ✖ | ✖ |
无序列表 | ✖ | ✔ |
有序列表 | ✖ | ✔ |
预格式化文本 | ✔ | ✔ |
blockquote | ✔ | ✔ |
超链接 | ✔ | ✔ |
图像链接 | ✔ | ✖ |
单个平台的支持
对文本格式的支持因消息类型和平台而异。
仅文本邮件
样式 | 桌面 | iOS | Android |
---|---|---|---|
bold | ✔ | ✔ | ✔ |
italic | ✔ | ✔ | ✔ |
标头 (级别 1-3) | ✖ | ✖ | ✖ |
删除线 | ✔ | ✔ | ✖ |
水平规则 | ✖ | ✖ | ✖ |
无序列表 | ✔ | ✖ | ✖ |
有序列表 | ✔ | ✖ | ✖ |
预格式化文本 | ✔ | ✔ | ✔ |
blockquote | ✔ | ✔ | ✔ |
超链接 | ✔ | ✔ | ✔ |
图像链接 | ✔ | ✔ | ✔ |
文本格式设置示例
样式 | 示例 | Markdown | XML (HTML) |
---|---|---|---|
bold | text | **text** |
<strong>text</strong> |
italic | text | *text* |
<em>text</em> |
标头 (级别 1-3) | Text | ### Text |
<h3>Text</h3> |
删除线 |
|
~~text~~ |
<strike>text</strike> |
无序列表 |
|
* text * text |
<ul><li>text</li><li>text</li></ul> |
有序列表 |
|
1. text 2. text |
<ol><li>text</li><li>text</li></ol> |
预格式化文本 | text |
`text` |
<pre>text</pre> |
blockquote | text |
>text |
<blockquote>text</blockquote> |
超链接 | 必应 | [Bing](https://www.bing.com/) |
<a href="https://www.bing.com/">Bing</a> |
图像链接 | ![Duck on a rock](http://aka.ms/Fo983c) |
<img src="https://aka.ms/Fo983c" alt="Duck on a rock"></img> |