Learn how to naturally format your content with Markdown syntax. 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.
In this article
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 ---------------
Bold and Italics
Wrap text with double **asterisks** or __underscores__ to bold. Wrap text with single *asterisk* or _underscore_ to italicize.
Wrap text with double asterisks or underscores to bold.
Wrap text with a single asterisk or underscore to italicize.
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.
This is a link text within the content.
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.
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
- 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
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.
This is a fantastic quote that needs your attention.
This line is still part of the same quote.
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.
=== --- ___
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 |
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 |
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