Markdown Guide — Part 3: Basic Quotation Syntax
1. Basic Quotation Syntax
Markdown uses the > symbol to create blockquotes.
When a line begins with >, the text on that line is recognized as a quoted paragraph.
Example:
> This is a quoted paragraph.
Rendered Output:
This is a quoted paragraph.
If you want to include multiple lines in a single blockquote, you can add > at the beginning of each line,
or place one > before the paragraph and leave a blank line between sections:
> Markdown is a lightweight markup language.
> It helps make text structure clearer and easier to read.
Rendered Output:
Markdown is a lightweight markup language.
It helps make text structure clearer and easier to read.
2. Nested Blockquotes
Blockquotes can also be nested.
Each additional level of nesting adds one more > symbol.
Example:
> Level 1 quote
>> Level 2 quote
>>> Level 3 quote
Rendered Output:
Level 1 quote
Level 2 quote
Level 3 quote
Avoid nesting blockquotes too deeply — two levels are usually sufficient.
Excessive nesting may reduce readability.
3. Common Mistakes
| Incorrect Usage | Problem Description | Correct Usage |
|---|---|---|
Missing space: >quote text |
Some renderers may fail to recognize it | > Quote text |
| Mixing quotes with normal text | Causes structural confusion | Leave a blank line between quotes and body text |
| Overly nested quotes | Hard to read | Keep it within two levels |
4. Advanced Techniques
-
Multi-paragraph Quotes
To maintain a blockquote across multiple paragraphs, add
>before each paragraph.> First paragraph. > > Second paragraph.Rendered Output:
First paragraph.
Second paragraph.
-
Quoting Within Quotes
You can include another person’s quote inside your own quote to indicate different levels of information:
> Zhang said: >> “Markdown’s quoting feature is very practical.”Rendered Output:
Zhang said:
“Markdown’s quoting feature is very practical.”
