Onesheet Example

What is a Onesheet? #

A onesheet is a single-page reference document — dense, scannable, and designed to fit on one printed A4 page. Set onesheet: true in your frontmatter to activate the two-column layout automatically.

On screen it renders as two columns (single column on small mobile). When printed, everything is scaled to fit on one A4 page with tight margins and compact typography.

Frontmatter Options #

Layout Behaviour #

The layout adapts to the viewport:

• Mobile (< 480px) — single column, full width
• Tablet / Desktop — two columns, balanced with column-gap
• Print (A4) — two columns at 9pt, margins reduced to 10mm

Headings at h1 level span both columns. All other block elements avoid breaking across column boundaries.

Tips for Good Onesheet Content #

Use short paragraphs and tight lists. Avoid deeply nested structures. Tables work well for comparisons. Code blocks are rendered at 7pt in print — keep them brief.

• Keep sections short and self-contained
• Prefer bullet lists over long prose
• Use h2 to separate major sections
• Use h3 for sub-groupings within a section

Print Notes #

When you print this page, the browser will apply:

@page { size: A4 portrait; margin: 10mm }

Font size drops to 9pt and line height to 1.35 to maximise information density. If your content still overflows, shorten it — the onesheet is intentionally opinionated about fitting on one page.

Example Use Cases #

A onesheet works well for:

• Cheat sheets — keyboard shortcuts, CLI flags, API reference
• One-pagers — project proposals, feature summaries
• Reference cards — process steps, decision trees
• Event programmes — schedule, speaker list, venue info

Markdown Features Supported #

All standard markdown works inside a onesheet: bold, italic, inline code, links, and block elements like tables and lists above. Wikilinks and GFM tables are also supported.

Blockquotes render with the primary colour accent, same as the rest of the site.

Images are supported and will avoid breaking across columns.