Bot Framework markdown support by channel


When developing your Bot Framework bot you want to be sure exactly how your messages are rendering on the different channels that you enable.  Plain text messages can look pretty boring, so you might decide to use markdown to create richer text messages. If you are new to markdown, have a quick read here, then the rest of this article will make more sense.  Below is an extract taken from the BotBuilder documentation which describes the markdown supported by the Bot Framework itself, however it's important to note that not all channels themselves support markdown:

Bot Framework markdown support

Style       Example
Italic *Italic*
Bold **Bold**
Header1-5 #H1
Strikethrough ~~text~~
Hr
Unordered list * text
Ordered list 1. text
Pre `text`
Block quote > text
Link [bing](http://bing.com)
image link ![duck](http://aka.ms/Fo983c)

Sample Bot message

So how does each channel render the text then?  Let's consider the following message using markdown:

# Markdown test
**The** *quick* ~~brown~~ fox `jumped`

1.over

2.the

* lazy
* dogs.

A hyperlink for good measure: [Link](http://bing.com)
and now a random picture of a duck ![duck](http://aka.ms/Fo983c)

Channel markdown findings to date:

Channel    Markdown support    Screenshot
Email Y Email
Facebook Messenger N Messenger
GroupMe N GroupMe
Kik N kik
Skype Y Skype
Slack Y Slack
Telegram Y Telegram
Twilio N Twilio
Web Chat Y webchat

 

Channel markdown screenshots:

And now see how that message gets rendered on ALL of the current Bot Framework supported channels:

Email

Email


Messenger

Facebook Messenger


GroupMe

GroupMe


Kik

Kik


Skype

Skype


Slack

Slack


Telegram

Telegram


Twilio

Twilio


Web Chat

Web Chat

Comments (5)

  1. Norah says:

    Any plans to support Viber Channel ?

    1. Jamie Dalton says:

      You can explore the DirectLine channel, but would have to implement your own custom adaptor.

      1. Jamie Dalton says:

        Update: You can take a look at this repo: https://github.com/Viber/viber-bot-node and the corresponding npm package for node here: https://www.npmjs.com/package/botbuilder-viber

  2. henry zabalegui saavedra says:

    what about facebook today? article date is since last year

    1. Jamie Dalton says:

      This article was written before the bot framework team updated their documentation. You can now use the Channel Inspector available here: https://docs.botframework.com/en-us/channel-inspector/channels/Facebook?f=Markdown&e=example1

Skip to main content