Markdown is a lightweight markup language with plain-text-formatting syntax. This guide shows you how to use all the standard features with live examples and authoring references.

1. Headings#

Headings help structure your content and are automatically added to the Table of Contents.

Heading 1#

Heading 2#

Heading 3#

Heading 4#

Heading 5#

Heading 6#

How to author:

1
# Heading 1
2
## Heading 2
3
### Heading 3
4
#### Heading 4
5
##### Heading 5
6
###### Heading 6

2. Text Formatting#

Support for bold, italic, and strikethrough is standard.

• Bold text using double asterisks.
• Italic text using single asterisks.
• Bold and Italic using triple asterisks.
• Strikethrough text using double tildes.
• Inline code using backticks.

How to author:

1
- **Bold text**
2
- *Italic text*
3
- ***Bold and Italic***
4
- ~~Strikethrough text~~
5
- `Inline code`

3. Lists#

Unordered List#

• Item one
• Item two
  • Nested item
  • Another nested item
• Item three

How to author:

1
- Item one
2
- Item two
3
  - Nested item
4
- Item three

Ordered List#

1. First step
2. Second step
3. Third step
   1. Sub-step A
   2. Sub-step B

How to author:

1
1. First step
2
2. Second step
3
3. Third step
4
   1. Sub-step A
5
   2. Sub-step B

Task Lists#

• Completed task
• Incomplete task
• Planned task

How to author:

1
- [x] Completed task
2
- [ ] Incomplete task
3
- [ ] Planned task

4. Blockquotes#

Use blockquotes to highlight quotes or external references.

"The details are not the details. They make the design." — Charles Eames

Nested Blockquotes#

This is a top-level quote.

This is a nested quote.

How to author:

1
> "The details are not the details. They make the design."
2
> — Charles Eames
3

4
> This is a top-level quote.
5
> > This is a nested quote.

5. Links & Images#

Inline Links#

Next.js Documentation

How to author:

1
[Next.js Documentation](https://nextjs.org)

Reference Links#

Custom Link

How to author:

1
[Custom Link][1]
2

3
[1]: https://nextjs.org

Images#

Images are automatically styled with rounded corners and subtle borders.

How to author:

1
![Sample Image](https://images.unsplash.com/photo-1498050108023-c5249f4df085?w=800&auto=format&fit=crop)

6. Tables#

Tables are rendered with a clean, documentation-style aesthetic.

How to author:

1
| Feature | Support | Performance |
2
| :--- | :---: | ---: |
3
| Markdown | 100% | High |
4
| Charts | Native | Extreme |
5
| CSS v4 | Native | Optimized |

7. Footnotes#

Footnotes are great for adding citations or extra context without cluttering the main text.

Here is a simple footnote¹. With another one here².

How to author:

1
Here is a simple footnote[^1].
2

3
[^1]: This is the first footnote.

8. Separators#

Use horizontal rules to divide your content sections.

How to author:

1
---

9. Custom Callouts (JSX)#

While not standard Markdown, these JSX components are available for enhanced noticeability.

How to author:

1
<Tip>This is a tip for your readers.</Tip>
2
<Info>This is important information.</Info>
3
<Note>This is a general note.</Note>
4
<Warning>This is an important warning.</Warning>
5
<Danger>This is a critical danger alert.</Danger>

Happy Writing!