A quick guide

Learn Markdown

A lightweight way to format plain text. Write once, render anywhere — docs, READMEs, notes, and more.

View the cheat sheet ↓
What is it?

Plain text with superpowers

Markdown was created by John Gruber in 2004 with a simple goal: be readable as-is, without looking like it's been tagged up. A # makes a heading. Wrapping words in **double asterisks** makes them bold. That's it.

Today it's used everywhere — GitHub, Notion, Slack, and documentation sites. Once you know the syntax, you'll reach for it constantly.


Reference

Cheat sheet

Every major element with the raw syntax on the left and the rendered result on the right.

MarkdownResult
Headings
# Heading 1 ## Heading 2 ### Heading 3

Heading 1

Heading 2

Heading 3

Emphasis
**bold** *italic* ***bold italic***
bold
italic
bold italic
Inline Code
Use `backticks` for code
Use backticks for code
Code Block
```python def hello(): print("hi") ```
def hello():
    print("hi")
Unordered List
- Apples - Bananas - Cherries
  • Apples
  • Bananas
  • Cherries
Ordered List
1. First 2. Second 3. Third
  1. First
  2. Second
  3. Third
Task List
- [x] Done - [ ] Not done yet
  • Done
  • Not done yet
Link
[Link text](https://example.com)
Blockquote
> This is a blockquote.
This is a blockquote.
Table
| Name | Score | |-------|-------| | Alice | 95 | | Bob | 88 |
NameScore
Alice95
Bob88
Horizontal Rule
---

Try it yourself

Write markdown on the left and see it rendered instantly on the right.

Markdown
Preview

Your rendered output will appear here.