1.9 Obsidian Design Tokens & Themes
The Standard Garden Obsidian plugin turns frontmatter metadata into a live, typographic design system. You can style individual notes or your entire workspace using bare frontmatter keys that map directly to CSS variables with zero abstraction.
1. How Tokens Work
The plugin reads frontmatter keys in the active note, checks them against the canonical token dictionary, and injects a matching CSS variable with !important onto html body:
---
font-text: "EB Garamond"
optical-ratio: 1.25
color-light-accent: "#b45309"
---
Translates at runtime directly to:
html body {
--font-text: "EB Garamond" !important;
--optical-ratio: 1.25 !important;
--color-light-accent: #b45309 !important;
}
The key name is the CSS property name minus the -- prefix. No namespace prefix, no extra configuration.
2. Built-in Curated Themes
Standard Garden includes 27+ curated themes crafted for typography and long-form reading. You can activate a theme globally in plugin settings or apply it to a single note:
---
theme: humanist
---
Popular Themes
| Theme | Character & Atmosphere | Recommended Use |
|---|---|---|
humanist |
Clean, classical book serif with warm off-white paper. | Long-form essays and literature. |
forest |
Organic botanical greens with earthen contrasts. | Natural history, field notes, ecology. |
carnel |
Rich terracotta warmth and balanced reading rhythm. | Personal reflections and philosophy. |
documentation |
Structured precision with subtle blueprint tints. | Engineering logs, code notes, specifications. |
exhibit |
Modernist gallery layout with high-contrast display type. | Portfolios and art documentation. |
editorial |
High-fashion editorial serif with tight vertical measure. | Magazine-style articles and criticism. |
journal |
Quiet diary aesthetics designed for unhurried thought. | Daily journaling and private logs. |
You can also switch themes dynamically using the command palette: Standard Garden: Set note theme or by clicking Let’s Hyphe design this in the side panel to generate a custom palette tailored to your note’s subject matter.
3. Typography Tokens
Active when Settings → Standard Garden → Design System is enabled.
| Frontmatter Key | CSS Variable | Description |
|---|---|---|
font-text |
--font-text |
Body text typeface (auto-imported from local or Google Fonts). |
font-header |
--font-header |
Heading typeface (H1–H6 and inline titles). |
font-monospace |
--font-monospace |
Code blocks and inline monospace text. |
font-interface |
--font-interface |
Obsidian UI and menu typography. |
optical-ratio |
--optical-ratio |
Modular type scale multiplier (1.2 = minor third, 1.25 = major third, 1.333 = perfect fourth). |
font-density |
--font-density |
Line-height multiplier and baseline density. |
prose-width |
--prose-width |
Maximum reading measure for paragraphs (e.g. 68ch, 38rlh). |
font-weight |
--font-weight |
Regular body weight (400). |
font-weight-bold |
--font-weight-bold |
Bold text weight (600, 700). |
font-header-weight |
--font-header-weight |
Weight for all headings. |
font-header-letter-spacing |
--font-header-letter-spacing |
Heading letter spacing (e.g. -0.02em). |
font-header-line-height |
--font-header-line-height |
Heading line height multiplier. |
font-header-style |
--font-header-style |
Heading style (normal or italic). |
font-feature |
--font-feature |
OpenType font features for prose ("'liga', 'kern'"). |
font-variation |
--font-variation |
Variable font axis settings ("'wght' 450"). |
4. Color Tokens
Light Theme Palettes
| Frontmatter Key | CSS Variable | Target |
|---|---|---|
color-light-background |
--color-light-background |
Note paper / canvas background. |
color-light-foreground |
--color-light-foreground |
Primary prose ink color. |
color-light-accent |
--color-light-accent |
Interactive links and primary signal color. |
color-light-red |
--color-light-red |
Warning and deletion highlights. |
color-light-orange |
--color-light-orange |
Caution and pending highlights. |
color-light-yellow |
--color-light-yellow |
Standard highlighter yellow. |
color-light-green |
--color-light-green |
Fresh additions and success highlights. |
color-light-cyan |
--color-light-cyan |
Technical callouts and code highlights. |
color-light-blue |
--color-light-blue |
Secondary accent and information links. |
color-light-purple |
--color-light-purple |
Thought callouts and philosophical links. |
color-light-pink |
--color-light-pink |
Rose accent highlights. |
color-light-bold |
--color-light-bold |
Dedicated ink color for bold text. |
color-light-italic |
--color-light-italic |
Dedicated ink color for italic text. |
Dark Theme Palettes
The dark mode palette mirrors the exact same structure: replace -light- with -dark- (e.g., color-dark-background, color-dark-foreground, color-dark-accent). Both sets can live simultaneously in the same note, adapting automatically when Obsidian toggles between light and dark modes.
5. Fine Color Control
You can also target specific semantic elements regardless of theme mode:
| Frontmatter Key | CSS Variable | Function |
|---|---|---|
color-header |
--color-header |
Color for all headings (H1–H6). |
color-bold |
--color-bold |
Override for bold text in both modes. |
color-italic |
--color-italic |
Override for italic text in both modes. |
color-accent |
--color-accent |
Override for links and active buttons. |
See Also
- The Obsidian Atelier — installation, sync, and publication workflow
- CSS & Rendering Hooks — classes injected onto notes for custom stylesheets
- Styling the Soil — full frontmatter metadata reference