A Block on a Page With Content

Blocks render above the page header, so on a page that also carries content their titles are subsections and the page title below them remains the only h1.

What the Blocks Look Like

Level From the Page

A page template hands its blocks a heading level. A list page renders no header, so its first titled block opens the page. This page renders a header, so its blocks start one level down.

Level From the Block

A block can set heading_level itself to pin a level, or 0 to keep the plain division it rendered before heading levels existed.

Level From the Page

A page template hands its blocks a heading level. A list page renders no header, so its first titled block opens the page. This page renders a header, so its blocks start one level down.

Level From the Block

A block can set heading_level itself to pin a level, or 0 to keep the plain division it rendered before heading levels existed.

Blocks Demo

1 min read • 61 words

Link copied to clipboard

A single page that carries both content blocks and regular page content.

Regular Page Content

Everything above this heading comes from content_blocks in the front matter. Everything from here down is ordinary Markdown, rendered through the page header and body.

The page title is the h1. The two block titles above are h2, and this heading is an h2 as well, so the page carries exactly one h1 and skips no levels.