Markdown Formatting
In most areas, you don't need to use Markdown or HTML to format your content, and instead, you can use the simple rich-text Editor to format content.
This help doc explains how to format your content in a natural way with the Markdown syntax if you are using the Code entry of the content box and it is available for that type of content. It is as easy as writing plain text. Markdown supports the following formatting options: Headings, Bold, Italics, Links, Images, Lists, Quotes, Horizontal Line, and Tables.
NOTE: The Markdown formatting and HTML only apply when you are in the Code view of any content box. It is not valid in the rich-text Editor view.
In this article
Headings
Use the number-sign / hash-symbol to format a heading or sub-heading. Be sure to leave a blank line above (if there is an adjacent text line) and below the heading.
# Heading 1 ## Heading 2 ### Heading 3 #### Heading 4
You may alternatively use the following format for Heading 1 and Heading 2.
Heading 1 ======== Heading 2 ---------------
OUTPUT
Heading 1
Heading 2
Heading 3
Heading 4
Bold and Italics
Wrap text with double **asterisks** or __underscores__ to bold. Wrap text with single *asterisk* or _underscore_ to italicize.
OUTPUT
Wrap text with double asterisks or underscores to bold.
Wrap text with a single asterisk or underscore to italicize.
Links
You create links to anything on the web. Like articles, hosted video or audio, and social media pages.
Important note: There must not be any spaces between the first set of brackets [...] and the second set of brackets (...) to create a valid link.
This is a [link text](http://www.example.com) within content.
OUTPUT
This is a link text within the content.
Images
Below is how you insert an image on its own line. You can also place this image code as the text of a link to make it linked to another location.
Important note: There must not be any spaces between the first set of brackets [...] and the second set of brackets (...) to create a valid image code.
![](http://www.example.com/image.jpg)
OUTPUT
Lists
You can easily create ordered and unordered lists using natural text with Markdown formatting.
Note: leading and trailing spaces are shown with dots.
1. First ordered list item 2. Another item ⋅⋅⋅* Unordered sub-list 1. Actual numbers don't matter, just that it's a number ⋅⋅⋅1. Ordered sub-list 4. Here is another item ⋅⋅⋅You can have properly indented paragraphs within list ⋅⋅⋅items. Notice the blank line above, and the leading spaces (at least one, ⋅⋅⋅but we'll use three here to also align the raw Markdown). ⋅⋅⋅To have a line break without a paragraph, you will need ⋅⋅⋅to use two trailing spaces.⋅⋅ ⋅⋅⋅Note that this line is separate, but within the same paragraph. * Unordered list can use asterisks - or hyphens + or pluses
OUTPUT
- First ordered list item
- Another item
- Unordered sub-list
- Actual numbers don't matter, just that it's a number
- Ordered sub-list
Here is another item
You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).
To have a line break without a paragraph, you will need to use two trailing spaces.
Note that this line is separate but within the same paragraph.
- The unordered list can use asterisks
- or hyphens
- or pluses
Quotes
To have a quote displayed with proper formatting, start a line with a right angle-bracket >
. You can also have another Markdown-formatted text inside the quote.
> This is a fantastic quote that needs your attention. > This line is **still** part of the same quote.
OUTPUT
This is a fantastic quote that needs your attention.
This line is still part of the same quote.
Horizontal Line
You can separate content with a horizontal line using three or more consecutive equal-signs, hyphens, or underscores, along with a leading and trailing blank lines.
=== --- ___
OUTPUT
Tables
You can format your text as columns and rows of a simple table by using pipes |
and hyphens -
like so:
| Col1 | Col2 | Col3 | | --- | --- | --- | | Cell | Cell | Cell | | Cell | Cell | Cell |
OUTPUT
Col1 | Col2 | Col3 |
---|---|---|
Cell | Cell | Cell |
Cell | Cell | Cell |
You can align text to the left, right, or center of a column by including colons :
to the left, right, or on both sides of the hyphens within the header row.
| Left | Center | Right | | :--- | :----: | ----: | | Cell | Cell | Cell | | Cell | Cell | Cell |
OUTPUT
Left | Center | Right |
---|---|---|
Cell | Cell | Cell |
Cell | Cell | Cell |
The outer pipes |
are optional, and you don't need to make the raw Markdown line up. You can also use inline Markdown.
A | B | C --- | --- | --- **value** | _value_ | value **value** | _value_ | value
OUTPUT
A | B | C |
---|---|---|
value | value | value |
value | value | value |