This article explains how to use Markdown language to format Power Automate approval requests. It covers supported Markdown elements like headers, lists, tables, emphasis, and special characters, and notes limitations across different platforms such as Outlook, Teams, and Power Automate. The guide includes examples to help users apply Markdown effectively, improving the readability and organization of approval requests. Markdown support varies by client, so compatibility details are provided below.
Before starting the details, there are a few points to keep in mind.
- Approval request emails are actionable. If your Microsoft Outlook client does not enable actionable messages, it will display approval requests in HTML format.
- All markdown renderers have different implementations. For more information, see the Client Support section.
- The Approvals app on Microsoft Teams does not currently support Markdown syntax.
Clients provide inconsistent support for Markdown. Inconsistencies persist despite efforts by the Power Automate team to address them. The following table lists the known limitations among the supported clients.
Headers
Use headings to structure your comments. Headers separate lengthy comments, making them simpler to read.
To set a heading, start a line with the hash character #. Organize your observations with subheadings by beginning each line with an additional hash character, such as ####. It supports up to six levels of headers.
Example
# This is a H1 header
## This is a H2 header
### This is a H3 header
#### This is a H4 header
##### This is a H5 header
Result
Paragraphs and line breaks
Make your writing easier to read by using paragraphs or line breaks. Enter two spaces before the line break to have most clients start a new line.
Example
This is line 1.(space)
Now text will appear on the next line.
Result
This is line 1.
Now, text will appear on the next line.
Example 2
This is line 1.
Line 2 has extra space before it.
Result
This is line 1.
Line 2 has extra space before it.
Lists
Create lists to organize related objects. You can include ordered lists with numbers or unordered lists with only bullets.
Ordered lists begin with a number followed by a period for each list item. Unordered lists begin with an asterisk. Start each list item on a new line. To begin a new paragraph in a Markdown file or widget, type two spaces before the line break, or two line breaks in a row.
Join the conversation! Your thoughts help the community grow.