The Writer — Editorial Mastery & Vault Publishing
The master editorial blueprint for publishing book-grade Markdown notes, essays, and Obsidian vaults with zero CSS.
Standard was born out of a quiet rebellion against the modern web: why should writing online require fighting with complex CMS platforms, bloated dependencies, and fragile CSS?
If you write in Obsidian, iA Writer, or plain text Markdown, your words already exist in the most durable, portable, and future-proof format ever devised. Standard ensures that when those words meet the web, they are presented with the typographic rigor, baseline harmony, and tactile beauty of a prestige Swiss book — with zero manual styling.
1. The Editorial Manifesto
Every editorial capability in Standard is guided by three non-negotiable invariants:
flowchart LR
A["1. The File is Yours<br/>(Portable Plain Text)"] --> B["2. Beauty is Default<br/>(Book-Grade Swiss Typography)"] --> C["3. Zero-Friction Web<br/>(10s from Thought to URL)"]
- The File is Yours: Everything begins and ends with plain text files (
.md). Applications and themes are interchangeable readers. If the servers disappear tomorrow, your library remains intact, legible, and completely yours. - Beauty is Default: You should never have to configure margins, leading, or font pairings to deserve good typography. Your grandmother’s recipe should look like it belongs in an art gallery without touching a single line of CSS.
- Friction is the Enemy: Ten seconds from a thought in your Obsidian vault to a published URL on the edge. Speed is a form of respect for both writer and reader.
2. Zero-File Art Direction (The Token Rule)
In Standard, you do not need to write stylesheets or configure bundlers to customize the appearance of an essay or entire site.
Standard enforces the Token Rule:
Any custom key declared in a note’s YAML frontmatter maps directly to a CSS Custom Property on the rendered page (
key === --var).
---
title: The Architecture of Solitude
theme: academic
prose-width: 38rem
color-accent: "oklch(0.65 0.22 25)"
font-text: newsreader
font-header: fraunces
---
When this note is rendered, Standard automatically applies:
data-theme="academic"on the document root.--prose-width: 38remto constrain the reading line to the golden measure.--color-accent: oklch(...)for custom link and quotation highlights.--font-text: 'Newsreader'and--font-header: 'Fraunces'with optical metrics pre-aligned to the baseline grid.
Scoping & Cascading
- Global / Site-wide Theming: Place frontmatter tokens in your root
index.mdnote. Every note across your publication inherits these settings automatically. - Per-Note Art Direction: Set tokens in an individual note’s frontmatter. The note art-directs itself, overriding global defaults without leaking styles to neighboring pages.
3. The 34 OKLCH Themes & Temperaments
Standard ships with 34 native, handcrafted themes calibrated in the OKLCH color space.
Unlike traditional RGB or HSL palettes, OKLCH is perceptually uniform: perceived lightness and contrast remain mathematically constant across all hues. Every theme guarantees a contrast ratio ≥ 7:1 (AAA) between body text and surface, adapting seamlessly between light and dark modes.
flowchart TD
subgraph Scholarly ["Scholarly & Classical"]
T1["Academic · Book · Editorial · Humanist"]
end
subgraph Zen ["Quiet & Contemplative"]
T2["Calm · Untitled · Minimal"]
end
subgraph Precision ["Technical & Engineering"]
T3["Mono · High Contrast · Documentation"]
end
subgraph Specialty ["Hardware & Optical Specialists"]
T4["E-Ink (E-paper simulation) · macOS (Dynamic system) · Dyslexia"]
end
Four Curated Temperaments
- Scholarly & Classical (
academic,book,editorial,humanist): High-literary typography, serif body measures, generous margins, and subtle warm-paper backdrops. - Quiet & Contemplative (
calm,untitled): Zero-distraction reading environments designed for slow essays, philosophy, and personal memoirs. - Technical & Engineering (
mono,high-contrast,documentation): Monospaced tabular data, crisp dividers, high-contrast syntax highlighting, and Swiss grid telemetry. - Hardware & Optical Specialists (
eink,macos,dyslexia):eink: Pure black-and-white, zero-blur contrast optimized for e-paper devices.macos: Dynamically inherits the user’s native Apple system accent color.dyslexia: Tuned for neurodivergent reading comfort with specialized optical tracking and letterforms.
To test any theme, add theme: <name> to your note’s frontmatter, or switch themes live using the theme selector in the top navigation bar.
4. Markdown Specification & Extended Syntax
Standard’s markdown engine (@stnd/press) parses standard CommonMark with first-class support for Obsidian conventions:
Obsidian Wikilinks
Bidirectional connections form the backbone of a digital garden or knowledge vault:
<!-- Standard note link -->
[[The Nature of Software]]
<!-- Aliased link with custom anchor text -->
[[The Nature of Software|read my earlier essay on software]]
Standard automatically resolves wikilinks to clean canonical URLs and computes the bidirectional backlink graph.
Semantic Callouts
Callouts adapt automatically to the active theme’s surface roles and border radiuses:
> [!note]
> Neutral contextual commentary or background reading.
> [!tip]
> Practical advice, shortcuts, and best practices.
> [!important]
> Core invariants and essential prerequisites.
> [!warning]
> Potential pitfalls, breaking changes, or regressions.
> [!caution]
> High-risk operations and destructive actions.
Footnotes & Citations
Swiss typography treats footnotes as first-class marginalia[^1].
[^1]: Josef Müller-Brockmann, *Grid Systems in Graphic Design*, 1981.
Footnotes render with superscript numeric anchors that jump smoothly to the bibliography section at the bottom of the article.
Mathematical Typesetting (KaTeX)
Write LaTeX math directly in your notes without external image generators:
- Inline:
$E = mc^2$ - Display Block:
$$ \sigma = \sqrt{\frac{1}{N} \sum_{i=1}^N (x_i - \mu)^2} $$
Architecture Diagrams (Mermaid)
Declare declarative flowcharts, sequence diagrams, and class charts inside standard ```mermaid code fences. Standard renders them as sharp, responsive SVG diagrams that invert colors automatically in dark mode.
5. Publishing Topologies (From Zero to Live)
Choose the publishing architecture that fits your volume and workflow:
| Architecture | Best For | Scaffolding Command |
|---|---|---|
| Personal Blog | Essays, articles, reading times, chronological archive | npx @stnd/cli new my-blog --template blog |
| Digital Garden | Non-linear knowledge base, bidirectional graph, vault sync | npx @stnd/cli new my-garden --template garden |
| Single Essay / Landing | Standalone manifesto or launch announcement | npx @stnd/cli new my-page --template landing |
6. Where to Go Next
- Frontmatter Specification: The complete taxonomy of machine-readable frontmatter keys.
- Markdown Specification: Live specimens of all typography tags and callouts.
- Personal Blog Recipe: File tree and layout structure for launching a blog in 10 minutes.
- Themes Gallery: Visual showcase of the 34 native OKLCH themes.