Basic Syntax / Blockquotes

Blockquotes

A blockquote works well when you need to frame words that came from somewhere else: a reviewer comment, a decision note, or a quoted excerpt.

Basic Syntax

Add a > character before the paragraph:

> Ship the high-traffic pages first, then come back for the long tail.

Preview

Ship the high-traffic pages first, then come back for the long tail.

Multiple Paragraphs

Keep the marker on blank lines too if you want to preserve multiple paragraphs:

> This pass should fix navigation, dark mode contrast, and generic copy.
>
> Visual polish can continue later, but the information architecture should settle first.

Nested Blockquotes

Use a second > level to show quoted feedback inside a quote:

> Reviewer note:
>
>> The direction is better, but the syntax pages still read like a template site.

With Other Elements

Blockquotes can contain headings, lists, and emphasis:

> #### Docs Updates This Week
>
> - Rewrite homepage copy
> - Fix dark mode contrast
>
> Next: update **individual syntax pages** with more grounded examples.

Docs Updates This Week

  • Rewrite homepage copy
  • Fix dark mode contrast

Next: update individual syntax pages with more grounded examples.

Comments

Comments are currently unavailable.

Enable GitHub Discussions for this repository and complete the giscus configuration to turn comments on.