English
About this handbook

This handbook belongs to the template Example for QuartzControl. It explains the template and, at the same time, shows everything it can do.

The text here comes from a Markdown file, not from the configuration.

Body text

The width of the text

In this template the page grid decides how wide the text gets — not a rule on the paragraph. The frame gives the content six of twelve columns, which is 672 px on a page capped at 1440 px — at a font size of 1 rem, about 70 characters.

Out of the box Quartz does the same, only with different numbers: it caps the page through .page { max-width }.

What once stood here

An earlier version additionally capped the body text at 68 characters. That is common advice, but it means two places answer the same question — the column width and the line length — and the second has to be pulled along on every change to the frame. The decision now lies in the grid alone.

Headings

Six levels, but only four sizes. Levels 5 and 6 switch to capitals and letter-spacing, because a difference of one pixel is not information. The space sits above the heading, never below — the gap says what belongs to the heading.

Colour and underline. The underline is semi-transparent and set low, so that it does not cut through the descenders; on hover it becomes opaque. External links carry an arrow.

Quotes

Bar in the accent colour, tinted surface, upright text. Out of the box the text is italic — over several lines that reads worse, and a quote is a different voice, not a different tone.

Highlight

==marked== takes textHighlight — a warm yellow in light mode, the accent with transparency in dark mode. Both are measured against the text colour.

Which variables apply here

These 29 variables are read by the section body-content in content.scss. They can be changed in QuartzControl under Styles → Variables — without a line of CSS.

VariableValuealso applies to
--dark#17171A · dark #FCFCFA13 other components
--darkgray#333333 · dark #DDDDDD18 other components
--gray#5F5F5F · dark #A1A1A122 other components
--headerFont"Noto Sans", system-ui, "Segoe UI", Robot…15 other components
--icon-task-cancelledset in the stylesheet (foundation.scss)only here
--icon-task-doingset in the stylesheet (foundation.scss)only here
--icon-task-doneset in the stylesheet (foundation.scss)only here
--icon-task-forwardedset in the stylesheet (foundation.scss)only here
--icon-task-openset in the stylesheet (foundation.scss)only here
--icon-task-questionset in the stylesheet (foundation.scss)only here
--secondary#1463A3 · dark #699DC319 other components
--tertiary#196B6B · dark #2CAFAD2.9 – Diagrams, The instances
--textHighlightrgba(226, 189, 92, 0.55) · dark rgba(140, 184, 218, 0.30)Search results
--tpl-accent-bar3px6 other components
--tpl-motion150ms ease13 other components
--tpl-radius-md8px17 other components
--tpl-radius-sm4px10 other components
--tpl-rulevar(--lightgray) = #DDDDDD19 other components
--tpl-rule-strongvar(--gray) = #5F5F5F8 other components
--tpl-rule-width1px25 other components
--tpl-space-2xs0.25rem16 other components
--tpl-space-lg1.5rem12 other components
--tpl-space-md1rem18 other components
--tpl-space-sm0.75rem10 other components
--tpl-space-xl2.5rem5 other components
--tpl-space-xs0.5rem20 other components
--tpl-surface-tintvar(--highlight) = rgba(42, 78, 108, 0.10)14 other components
--tpl-text-sm0.875rem20 other components
--tpl-underline-offset0.18em6 other components

This table is generated: it is read out of the stylesheets rather than kept by hand.

Read on

This page belongs to Example — the example template for QuartzControl. An overview of every area is on the English home page.

On a narrow screen the navigation is collapsed at the top.