teams-message-formatting
Installation
SKILL.md
Teams Message Formatting
Microsoft Teams has several incompatible text systems. Pick the surface first, then write the text for that surface.
CRITICAL: Four Markup Systems
| System | Used In | Bold | Link | Mention |
|---|---|---|---|---|
Bot text markdown |
Bot Framework/Teams SDK activity text |
**bold** |
[text](url) |
<at>Name</at> plus entities |
Bot text xml |
Bot activity textFormat: "xml" and some rich-card text fields |
<strong>bold</strong> |
<a href="url">text</a> |
<at>Name</at> plus entities |
| Adaptive Card Markdown | TextBlock.text, Fact.title, Fact.value |
**bold** |
[text](url) |
<at>Name</at> plus root msteams.entities |
Graph chatMessage HTML |
Microsoft Graph chatMessage.body.contentType: "html" |
<strong>bold</strong> |
<a href="url">text</a> |
<at id="0">Name</at> plus mentions |
Do not mix them. Slack mrkdwn (*bold*, <url|text>) is wrong in Teams. Full standard Markdown is also wrong in Adaptive Cards because headings, tables, images, code fences, and blockquotes are not supported in TextBlock.