Formatting Messages

Webex Teams clients, across all platforms, can send and receive a limited form of rich text formatted using the Markdown markup language. Bots and integrations can also send rich text messages formatted with Markdown, by using the Messages API.

Sending formatted text is super easy using the markdown parameter in the Messages API, though only a limited set of Markdown is supported at this time. See below for examples of the formatting supported in the Webex Teams clients.

But, before we dive into the examples below, there's an important note we need to mention about line breaks: The examples below do not include any JSON newline characters (\n) to create line breaks in Webex Teams messages—we've left them out to focus on just the specific Markdown example. To include line breaks in your JSON message body, use standard Markdown paragraphs and line breaks with JSON newline characters. For example, to create distinct paragraphs, use two newline characters between the paragraphs:

Paragraph 1\n\nParagraph 2

Or, for a single break between lines, end the line with two spaces followed by a single newline character:

Line 1  \nLine 2
You're not logged in. to run these formatting examples in your Webex Teams client.


**Title:** Add support for multiple file uploads

**Status:** Closed


This is *the best* launch we've had so far!


Should we try the sushi place for lunch?
- [Oh yea!](
- [Ewww Sushi](
- [Not today](

Ordered Lists

Priorities for the week are:
1. Collect Underpants
2. ???
3. Profit

Unordered Lists

Good morning Joe Fu. Here's your todo list:
- Review that really important thing.
- Meet Jason for lunch.
- Buy a new shirt. The one you're wearing is terrible.

Block Quotes

Alice, last week you said:
> I don't care what is costs. Let's book The Chainsmokers to headline Cisco Live.

Christine from finance laughed and is now questioning our sanity.

In-Line Code

Mike, I think the issue is with the `hasPermission` function

Fenced Code Blocks

Hello world in golang
package main

import "fmt"

func main() {
	fmt.Println("Hello, 世界")


Just like in the Webex Teams clients, @mentions can be used in messages to get someone's attention in a group room. To @mention someone, use one of the following methods to specify the person or group of people:

Mention by Email

Hi <|Bobby>, your order has been processed.

Mention by Person ID

We should get <@personId:Y2lzY29zcGFyazovL3VzL1BFT1BMRS9mNWIzNjE4Ny1jOGRkLTQ3MjctOGIyZi1mOWM0NDdmMjkwNDY|Jose> to look at that right away.

Mention by Group

<@all>, we have some exciting news! Please watch this space for more information...