The preview runs in your browser. Raw HTML is shown as text, images appear as placeholders, and only http, https, and mailto links can be clicked.
Syntax reference
Showing 30 of 30
**bold text**
What it does
Bold text. Two underscores on each side work too.
*italic text*
What it does
Italic text. One underscore on each side works too.
***bold and italic***
What it does
Bold and italic together, using three asterisks.
~~crossed out~~
What it does
Text with a line through it, using two tildes on each side.
First paragraph.
Second paragraph.
What it does
Leave a blank line between blocks of text to start a new paragraph.
First line\
Second line
What it does
A backslash at the end of a line, or two spaces there, starts a new line inside the same paragraph.
\*not italic\*
What it does
A backslash before a Markdown symbol shows the symbol itself.
# Heading 1
What it does
Top-level heading. Put a space after the number sign.
## Heading 2
What it does
Second-level heading, for main sections.
### Heading 3
What it does
Third-level heading, for subsections.
###### Heading 6
What it does
The smallest heading. Levels go from one to six number signs.
Heading 1
=========
Heading 2
---------
What it does
Alternative style: underline the text with equals signs for level 1 or hyphens for level 2.
- First item
- Second item
- Third item
What it does
Bulleted list. Start each line with a hyphen, asterisk, or plus sign.
1. First item
2. Second item
3. Third item
What it does
Numbered list. Start each line with a number and a period.
- Parent item
- Child item
- Child item
What it does
Indent an item by two or more spaces to nest it under the item above.
- [x] Finished task
- [ ] Open task
What it does
Checklist with checked and unchecked boxes.
[link text](https://example.com)
What it does
Link with the visible text in square brackets and the address in parentheses.
[link text](https://example.com "Tooltip")
What it does
Link with a tooltip, written in quotes after the address.
<https://example.com>
What it does
Angle brackets turn a web address into a link.
<hello@example.com>
What it does
Angle brackets turn an email address into a mail link.

What it does
Image. Written like a link with an exclamation mark in front; the bracket text describes the image.
`inline code`
What it does
Code inside a sentence, wrapped in backticks.
`` code with a ` backtick ``
What it does
Use double backticks when the code itself contains a backtick.
```
code block
```
What it does
Block of code between two lines of three backticks. The text inside is kept as typed.
```js
console.log("Hi");
```
What it does
Add a language name after the opening backticks so editors can highlight the code.
> Quoted text
What it does
Quoted text. Start the line with a greater-than sign.
> Quoted text
>> Nested quote
What it does
Add another greater-than sign to quote inside a quote.
---
What it does
Dividing line. Put three or more hyphens, asterisks, or underscores on their own line.
| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 |
What it does
Table. Separate columns with pipes and put a row of hyphens under the header.
| Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c |
What it does
Colons in the divider row align a column left, center, or right.
Markdown
What it does
**bold text**
Bold text. Two underscores on each side work too.
*italic text*
Italic text. One underscore on each side works too.
***bold and italic***
Bold and italic together, using three asterisks.
~~crossed out~~
Text with a line through it, using two tildes on each side.
First paragraph.
Second paragraph.
Leave a blank line between blocks of text to start a new paragraph.
First line\
Second line
A backslash at the end of a line, or two spaces there, starts a new line inside the same paragraph.
\*not italic\*
A backslash before a Markdown symbol shows the symbol itself.
# Heading 1
Top-level heading. Put a space after the number sign.
## Heading 2
Second-level heading, for main sections.
### Heading 3
Third-level heading, for subsections.
###### Heading 6
The smallest heading. Levels go from one to six number signs.
Heading 1
=========
Heading 2
---------
Alternative style: underline the text with equals signs for level 1 or hyphens for level 2.
- First item
- Second item
- Third item
Bulleted list. Start each line with a hyphen, asterisk, or plus sign.
1. First item
2. Second item
3. Third item
Numbered list. Start each line with a number and a period.
- Parent item
- Child item
- Child item
Indent an item by two or more spaces to nest it under the item above.
- [x] Finished task
- [ ] Open task
Checklist with checked and unchecked boxes.
[link text](https://example.com)
Link with the visible text in square brackets and the address in parentheses.
[link text](https://example.com "Tooltip")
Link with a tooltip, written in quotes after the address.
<https://example.com>
Angle brackets turn a web address into a link.
<hello@example.com>
Angle brackets turn an email address into a mail link.

Image. Written like a link with an exclamation mark in front; the bracket text describes the image.
`inline code`
Code inside a sentence, wrapped in backticks.
`` code with a ` backtick ``
Use double backticks when the code itself contains a backtick.
```
code block
```
Block of code between two lines of three backticks. The text inside is kept as typed.
```js
console.log("Hi");
```
Add a language name after the opening backticks so editors can highlight the code.
> Quoted text
Quoted text. Start the line with a greater-than sign.
> Quoted text
>> Nested quote
Add another greater-than sign to quote inside a quote.
---
Dividing line. Put three or more hyphens, asterisks, or underscores on their own line.
| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 |
Table. Separate columns with pipes and put a row of hyphens under the header.
| Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c |
Colons in the divider row align a column left, center, or right.
What Markdown Is
Markdown is a plain-text way to write formatted documents. A few symbols typed around ordinary words mark headings, emphasis, lists, links, and code, and the text stays readable even before it is converted.
It is used for README files, documentation, note-taking apps, chat messages, and many blogging tools. The editor above shows how each piece of syntax is rendered as you type.
Tips for Clean Markdown
Most problems come from spacing rather than from the symbols themselves.
Put a space after the number signs of a heading and after a list marker.
Leave a blank line before and after headings, lists, quotes, and code blocks.
Indent nested list items so they line up with the text of the item above.
Put a backslash before a symbol such as * or _ to show it as it is.
Frequently Asked Questions
Does Markdown look the same everywhere?+
The basics do. Headings, emphasis, lists, links, and code follow the CommonMark standard almost everywhere. Tables, task lists, and strikethrough are extensions made popular by GitHub, so a few apps do not support them.
Why doesn't the preview run my HTML or load my images?+
The preview is limited on purpose. Raw HTML is shown as text, images appear as labeled placeholders instead of being downloaded, and only http, https, and mailto links can be clicked.
Is the text I type sent anywhere?+
No. The preview is produced in your browser, and the text is not uploaded or saved.