Markdown
PagerDuty Workflow Automation supports Markdown for formatting in email bodies and task instructions. Markdown is a lightweight markup language which allows for formatting of plain text.
Markdown is simple “code” you can write in PagerDuty Workflow Automation to style text in email actions and instruction fields—this is used in many places across the web.
For example, to create bolded text, you write **bolded**
. Here’s a side by side view of the markdown syntax written in the instruction field of a Assign task to a user action on the left and how it appears to users on the right.

Where to learn more about formatting text with Markdown
- Markdown overview - This article is from the originator of the Markdown that PagerDuty Workflow Automation uses and explains the basics of using Markdown.
- Markdown conversion tool - This tool converts text into the Markdown format PagerDuty Workflow Automation uses.
- Table generator tool - This tool can quickly create a table in Markdown.
Markdown examples
You can use Markdown to set headers, create lists, add images or links, and apply bold, italics, or quotes.
Headers
What you write | What you get |
---|---|
# This is Header 1 |
![]() |
## This is Header 2 |
![]() |
### This is Header 3 |
![]() |
Emphasis and quotes
What you write | What you get |
---|---|
**This text is bolded** |
![]() |
_This text is italicized_ |
![]() |
_**This text is bolded and italicized**_ |
![]() |
> This is a blockquote |
![]() |
> This is a multiline blockquote |
![]() |
Lists
What you write | What you get |
---|---|
- This is |
![]() |
- This is |
![]() |
Horizontal Rule
To add a divider line, add three underscores.
What you write | What you get |
---|---|
___ |
![]() |
Images and links
What you write | What you get |
---|---|
 |
![]() |
[This is a link](http://that-will-go-to-this-address.net/) |
![]() |
Tables
Tables are more complicated, it’s generally recommended to use the Tables: Convert data table to markdown text or to generate a table automatically with a tool like tablesgenerator.com
What you write | What you get |
---|---|
| Fruit | Price | |
![]() |
Thanks for your feedback
We update the Help Center daily, so expect changes soon.
Link Copied
Paste this URL anywhere to link straight to the section.