MarkdownCheatsheet

Complete reference guide for all Markdown syntax. Learn headers, lists, tables, code blocks, and more with live interactive examples.

Headers

Create headings with different sizes

Markdown
# H1 Heading
Output
# H1 Heading
Markdown
## H2 Heading
Output
## H2 Heading
Markdown
### H3 Heading
Output
### H3 Heading
Markdown
#### H4 Heading
Output
#### H4 Heading
Markdown
##### H5 Heading
Output
##### H5 Heading
Markdown
###### H6 Heading
Output
###### H6 Heading

Text Formatting

Emphasize text with bold, italic, and more

Markdown
**bold text**
Output
**bold text**
Markdown
*italic text*
Output
*italic text*
Markdown
***bold and italic***
Output
***bold and italic***
Markdown
~~strikethrough~~
Output
~~strikethrough~~
Markdown
`inline code`
Output
`inline code`

Lists

Create ordered and unordered lists

Markdown
- Item 1
- Item 2
- Item 3
Output
- Item 1 - Item 2 - Item 3
Markdown
1. First item
2. Second item
3. Third item
Output
1. First item 2. Second item 3. Third item
Markdown
- Item 1
  - Nested item
  - Another nested
- Item 2
Output
- Item 1 - Nested item - Another nested - Item 2
Markdown
- [ ] Unchecked task
- [x] Checked task
Output
- [ ] Unchecked task - [x] Checked task

Links and Images

Add links and images to your content

Markdown
[Link text](https://example.com)
Output
[Link text](https://example.com)
Markdown
[Link with title](https://example.com "Title")
Output
[Link with title](https://example.com "Title")
Markdown
![Alt text](image.jpg)
Output
![Alt text](image.jpg)
Markdown
[![Image](image.jpg)](https://example.com)
Output
[![Image](image.jpg)](https://example.com)

Code Blocks

Display code with syntax highlighting

Markdown
```javascript
function greet() {
  return 'Hello';
}
```
Output
function greet() {
  return 'Hello';
}
Markdown
```python
def hello():
    print('Hello')
```
Output
def hello():
    print('Hello')
Markdown
```
Plain code block
```
Output
Plain code block

Tables

Create structured tables

Markdown
| Header 1 | Header 2 |
|----------|----------|
| Cell 1   | Cell 2   |
| Cell 3   | Cell 4   |
Output
| Header 1 | Header 2 | |----------|----------| | Cell 1 | Cell 2 | | Cell 3 | Cell 4 |
Markdown
| Left | Center | Right |
|:-----|:------:|------:|
| Left | Center | Right |
Output
| Left | Center | Right | |:-----|:------:|------:| | Left | Center | Right |

Blockquotes

Quote text or add callouts

Markdown
> This is a blockquote
Output
> This is a blockquote
Markdown
> Multi-line blockquote
> with multiple lines
Output
> Multi-line blockquote > with multiple lines
Markdown
> Nested quotes
>> Are also possible
Output
> Nested quotes >> Are also possible

Horizontal Rules

Create visual separators

Markdown
---
Output

Markdown
***
Output

Markdown
___
Output

Escaping Characters

Display special characters literally

Markdown
\*Not italic\*
Output
\*Not italic\*
Markdown
\# Not a heading
Output
\# Not a heading
Markdown
\`Not code\`
Output
\`Not code\`

Line Breaks

Control line spacing

Markdown
Line 1  
Line 2 (two spaces before newline)
Output
Line 1 Line 2 (two spaces before newline)
Markdown
Paragraph 1

Paragraph 2 (blank line)
Output
Paragraph 1 Paragraph 2 (blank line)

Quick Reference

Common Markdown syntax at a glance

# Header

H1 Header

## Header

H2 Header

**bold**

Bold text

*italic*

Italic text

`code`

Inline code

```code```

Code block

- List

Unordered list

1. List

Ordered list

[Link](url)

Create link

![Alt](img.jpg)

Insert image

> Quote

Blockquote

---

Horizontal rule

| Table |

Create table

- [ ] Task

Task list

~~text~~

Strikethrough

Where Markdown is Used

Software Documentation

GitHub README files, API documentation, changelogs, and contributing guides are almost universally written in Markdown. It integrates seamlessly with version control and renders automatically on platforms like GitHub, GitLab, and Bitbucket.

Note-Taking and Knowledge Bases

Apps like Obsidian, Notion, Bear, and Logseq use Markdown as their primary format. Learning Markdown lets you write faster and create well-structured notes that are portable across different tools and platforms.

Static Site Generators

Jekyll, Hugo, Gatsby, Next.js, and Astro all use Markdown for blog posts and content pages. Authors write in Markdown and the framework converts it to HTML at build time, combining simplicity with powerful templating.

Technical Writing and Publishing

Many technical books, research papers, and online courses are authored in Markdown. Tools like Pandoc convert Markdown to PDF, EPUB, LaTeX, and other publishing formats while maintaining clean, readable source files.

Frequently Asked Questions

Markdown is a lightweight markup language created by John Gruber in 2004. It lets you format text using simple, readable syntax that converts to HTML. It is widely used for documentation, README files, blog posts, notes, and technical writing. Markdown files use the .md or .markdown extension.
GitHub Flavored Markdown (GFM) is a superset of standard Markdown used on GitHub. It adds support for tables, task lists, strikethrough, fenced code blocks with syntax highlighting, and autolinked URLs. Most modern Markdown tools support GFM. Try our Live Markdown Preview to see GFM in action.
Use pipes (|) to separate columns and hyphens (-) to create the header row separator. Example: | Header 1 | Header 2 | then |----------|----------| then | Cell 1 | Cell 2 |. You can also use our Markdown Table Formatter to automatically align your tables.
Yes, most Markdown formatting can be nested. You can have bold text inside a list item, links inside headings, code inside bold text, and more. However, some combinations like nested blockquotes or deeply nested lists may render differently across Markdown processors.
Markdown is a simplified syntax that converts to HTML. It is easier to read and write than raw HTML, but supports fewer formatting options. For full HTML control, use our Markdown to HTML converter. Many Markdown processors also allow inline HTML for advanced formatting.
Popular Markdown editors include VS Code, Typora, Obsidian, Bear, iA Writer, Notion, and many more. GitHub, GitLab, Bitbucket, Reddit, Stack Overflow, and Discord all support Markdown in their text fields. Most static site generators (Jekyll, Hugo, Gatsby) use Markdown for content.
Use the syntax ![Alt text](image-url) to add images. You can also add a title: ![Alt text](image-url "Title"). For linked images, wrap the image syntax in a link: [![Alt](image.jpg)](https://example.com). Note that the image must be hosted somewhere accessible via URL.
Task lists (or checklists) use - [ ] for unchecked items and - [x] for checked items. They are a GitHub Flavored Markdown extension and render as interactive checkboxes on GitHub. They are commonly used in issue descriptions, pull requests, and project planning documents.

Ready to Convert Your Markdown?

Use our free conversion tools to transform your Markdown documents into any format you need.