Microsoft Teams comes with excellent lowcode/nocode tool for bots: Power Virtual Agents. Project Oakdale, which is now in preview, brought these bots directly to Teams licensed users to create bots that help tackle , for example, overload on people answering routine questions.
When you are creating the bot dialogue it is easy to use richer text formatting directly in the message:
However, if you try to use these with variable, like a value returned from your backend, database, CDS lite or just from a list, you are quite out of luck. You can not use a variable for displaying a link or use bolded text, for example, to display something you returned from the backend systems (I like to use remaining vacation days or saldo hours as example). So this means your output isn’t as beautified as users would like to see.
And if you have heard about the markdown syntax and used included directly in bot’s messages you have already found out it doesn’t work and might have skipped the whole idea of richening the text.
What markdown syntax is really supported in Teams?
There is a great reference in Microsoft Docs article for markdown – the article is related to Power Automate Approvals but it can start a guide for syntax on Power Automate as well. However with Power Virtual Agents you can use markdown more versatile than in Approvals. I updated the table here with PVA supported syntaxes:
Power Automate ❤ Markdown
You can use markdown in several places in Teams Power Automate actions and in Adaptive cards. Most likely all/many these are supported throughout Teams and not just in Power Virtual Agents. Just refer the table from this article to Markdown supported in Power Automate Approvals!
The trick is a simple one, but goes beyond nocode. You have to enter the world of Power Automate and lowcode. Don’t worry: it is not difficult and with these few simple examples you can enrich your bots to the next level.
For those already experienced: you need to return variables from Power Automate Flow back to Power Virtual Agents with markdown included and then include that variable in Power Virtual Agent’s dialogue message.
So first you need to create a Flow that helps you to define the returning variable.
Let’s bold the text first.
Create a new flow and first’ thing you do you rename it to something you remember and it fits the purpose of the Flow.
Add a input variable (text). In this case we call it the text to bold.
Then add return value to Power Virtual Agents, again of the type text:
Save you Flow and return back to the Power virtual Agents by choosing Close.
Hit the + sign again and Call to Action and choose your Flow from the list. Test it with your Display name as input and put the output to the message.
The last message is showing the following, for example
When we hit Test bot and activate the topic we can now see our own name bolded.
And just to prove why you need to use Flow to define the markdown you can try by adding markdown to the message box.
And you get the result:
Yes – it was proved. Let’s explore a two more easy ones:
This time I do a bit more different Flow, I don’t want to create a Flow for all markdowns so I add a input what I want to do:
Of course adding ALL possible combinations would require a few more entries to the switch so I just leave this as example. Markdown syntax is done as following
|**_TEXT_**||Bolded and italic|
Of course this kind of Flow only works if you get the action to variable.. For simplicity it might be easier to to use a single-action Flows. They are simpler to do as well.
Ok – the basic markdown syntax works.
Some things that I have found not to work are:
- video preview
Creating a link with markdown
Creating a link markdown Flow is quite useful to do, since it gets two parameters: link label and link target. This way it is very usable via all your team bots.
The link opens always to a new tab / window.
The Flow and markdown format are quite simple:
The markdown is formatted: [Title](LinkURL)
Showing a picture with markdown
Yes, picture can be shown in the bot as well. The Project Oakdale makes it possible to use pictures in Office 365 – like from a SharePoint library or list. As long as you have a URL to the actual picture you can display pictures within the text. For this one I use a sample from my other demo displaying onboarding process.
You can also use GIFs as image URLs and they work in Teams as well – making your bots fun if the process permits.
Note: URLs like picture thumbnails in SharePoint document library do expire in time. Don’t use them as static ones. #lessonslearned Always get the fresh URL in the Flow or make sure the URL doesn’t expire.
The markdown format is ![alternative text](linkUrl)
In the bot you call Call to Action and get show returned image-variable in a message.
I have to add big thanks to my colleague Matti Kukkamäki who had researched out how to add public pictures to Power Virtual Agent bots. I took that inspiration and carried onwards with pictures in Office 365 and also to dig more into what markdown was supported with these bots.
Creating a list and table
List and table are a bit more complicated, but still doable
There are three kinds of lists:
- 0. Text here
- 0. Text here
- – Text here
- – Text here
- 1. Top text
- – nested text
- – nested text
- 1. Top text 2
- nested text
- nested text
- 1. Top text
In Power Automate Flow you can use this to list items from, for example document library. Initialize the string variable in the beginning and then start adding rows
Creating a table
This is somewhat similar than the list, but in this one you need to define the list columns separated with | when you initialize the variable.
In the looping you just add rows to the table.
Again, remember to add a extra row after the last |.
You can define also up to five levels of headers in markdown syntax. However only the first 3 are really usable.
The headers are defined with # (hashtag) signs: number of hashtags equals the header level.
Testing in actual Teams bot
Of course testing inside the Test bot ( while in Teams PVA) is not the reality. Here are results of my testing with various parts.
- Image: works
- Header in Teams: works
- List in Teams: works
- Table in Teams: works
And on Teams mobile these look like this:
As can be seen the table is there, but user has to scroll it sideways to see everything.
And finally testing Bold + Italic and the link.
12 thoughts on “How to make your Teams bots richer with markdown”
Ӏ read this piece of wгiting fully concerning the resemblance of most
up-to-date and preceding technologies, it’s awesօme
Thank you so much @Vesa Nopanen. This is great article and it will help a lot for those who want to start work on Power Virtual Agent. Great Explanation.
I am glad you found it useful!
Hi Vesa, after following each step i still dont get to see the Image. in Teams. i just see kind of blank message. can assist ?
Test it with simple scenario
– Create a topic in PVA
– Show some text message
– Create a Flow to the bot that returns the image markdown, use some static url to a picture that is publicly available (not from SharePoint for example)
– Add the flow to the bot
– Get the flow result and display it in the message without anything extra
And troubleshooting it is good to check that you have correct markdown result.
I have integrated my bot in teams meeting chat, where mutiple users are starting the conversation with bot by mentioning the bot with
“@Bot_Name” and then asking there question, can you help me to design the bot in such a way that bot also mentions the same user who is asking the question, as we mention the user in teams which comes in bold and blue color the same way I am trying to do.
Perhaps Bot Framework at mentioning can help you?
For at mentions with Power Virtual Agents in Teams I use Power Automate and Team’s action to get the atMention tag.
This is not solving my issue, is there any other way?
I am sorry, but I don’t think I can help you with that. You should go to the Tech Community and post your question there https://techcommunity.microsoft.com/t5/teams-developer/bd-p/TeamsDeveloper
Thanks for this! Very cool that Power Virtual Agents can display images and tables, and I’ve just used the tables feature in my bot. But it’s crazy that it requires the use of Power Automate to just send some Markdown back – lift your game, Microsoft.
LikeLiked by 1 person
Does this work with code blocks?
I haven’t tried that. Now with Azure OpenAI GPT models that would be a really good feature. When I wrote the article I didn’t try code blocks and I haven’t had the need yet since code replies hasn’t been included on boy replies so far.