Use Markdown in Microsoft Flow approval requests

This article teaches you how to use Markdown syntax to add rich formatting and tables to your approval requests.

Headers

Structure your comments using headers. Headers segment longer comments, making them easier to read.

Start a line with a hash character # to set a heading. Organize your remarks with subheadings by starting a line with additional hash characters, for example ####. Up to six levels of headings are supported.

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:

Export flow

Paragraphs and line breaks

Make your text easier to read by breaking it up with paragraphs or line breaks. Enter two spaces prior to the line break to begin a new paragraph, or enter two line breaks consecutively to begin a new paragraph.

Example

Add lines between your text with the Enter key.
This spaces your text better and makes it easier to read.

Result:
Add lines between your text with the Enter key.
This spaces your text better and makes it easier to read.

Example 2

Add two spaces prior to the end of the line.(space, space)     
This adds space in between paragraphs.

Result:
Add two spaces prior to the end of the line.

This adds space in between paragraphs.

Lists

Organize related items with lists. You can add ordered lists with numbers, or unordered lists with just bullets.

Ordered lists start with a number followed by a period for each list item. Unordered lists start with a *. Begin each list item on a new line. In a Markdown file or widget, enter two spaces prior to the line break to begin a new paragraph, or enter two line breaks consecutively to begin a new paragraph.

Ordered or numbered lists

Example:

0. First item.
0. Second item.
0. Third item.

Result:

  1. First item.
  2. Second item.
  3. Third item.

Bullet lists

Example:


- Item 1
- Item 2
- Item 3

Result:

  • Item 1
  • Item 2
  • Item 3

Nested lists

Example:


1. First item.
   - Item 1
   - Item 2
   - Item 3
1. Second item.
   - Nested item 1
   - Nested item 2
   - Nested item 3

Result:

  1. First item.

    • Item 1
    • Item 2
    • Item 3
  2. Second item.

    • Nested item 1
    • Nested item 2
    • Nested item 3

HTTP and HTTPS URLs are automatically formatted as links.

You can set text hyperlinks for your URL using the standard markdown link syntax:

[Link Text](Link URL)

Example:

[Microsoft Flow](https://flow.microsoft.com)

Result:

Microsoft Flow

Anchor IDs are assigned to all headings when rendered as HTML. The ID is the heading text, with the spaces replaced by dashes (-) and all lower case.

Example:

###Link to a heading in the page

Result:

The syntax for an anchor link to a section...

[Link to a heading in the page](#link-to-a-heading-in-the-page)

The ID is all lower case, and the link is case sensitive, so be sure to use lower case, even though the heading itself uses upper case.

Tables

Organize structured data with tables.

  • Place each table row on its own line
  • Separate table cells using the pipe character |
  • The first two lines of a table set the column headers and the alignment of elements in the table
  • Use colons (:) when dividing the header and body of tables to specify column alignment (left, center, right)
  • To start a new line, use the HTML break tag (<br/>) (Works within a Wiki but not elsewhere)
  • Make sure to end each row with a CR or LF.

Example:

| Heading 1 | Heading 2 | Heading 3 |  
|-----------|:-----------:|-----------:|  
| Cell A1 | Cell A2 | Cell A3 |  
| Cell B1 | Cell B2 | Cell B3<br/>second line of text |  

Result:

Heading 1 Heading 2 Heading 3
Cell A1 Cell A2 Cell A3
Cell B1 Cell B2 Cell B3
second line of text

Emphasis (bold, italics, strikethrough)

You can emphasize text by applying bold, italics, or strikethrough to characters:

  • To apply italics: surround the text with an asterisk * or underscore _
  • To apply bold: surround the text with double asterisks **.
  • To apply strikethrough: surround the text with double tilde characters ~~.

Combine these elements to apply multiple emphasis to text.

Example:

Use _emphasis_ in comments to express **strong** opinions and point out ~~corrections~~ 
**_Bold, italicized text_**  
**~~Bold, strike-through text~~**

Result:

Use emphasis in comments to express strong opinions and point out corrections
Bold, italicized text
Bold, strike-through text

Special characters

Syntax Example/notes

To insert one of the following characters, prefix with a backslash:

```\ backslash ```

\` `backtick`

```_ underscore ```

```{} curly braces ```

```[] square brackets ```

```() parentheses ```

```# hash mark ```

```+ plus sign ```

```- minus sign (hyphen) ```

```. dot ```

```! exclamation mark ```

Some examples on inserting special characters

Enter ```\\``` to get \\

Enter ```\_``` to get _

Enter ```\#``` to get \#

Enter ```\(``` to get \(

Enter ```\.``` to get \.

Enter ```\!``` to get \!