Markdown Formatting

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

Headings

Use the 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 single asterisk or underscore to italicize.

You create links to anything on the web. Like to articles, hosted video or audio, and social media pages.

This is a [link text](http://www.example.com) within content.
OUTPUT

This is a link text within content.

Images

The 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 anthor location.

![](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
  1. First ordered list item
  2. Another item
    • Unordered sub-list
  3. 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

Quotes

To have a quote displayed with proper formatting, start a line with a right angle-bracket >. You can also have other Markdown formatting 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
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us