Quartz 4

⚙️ Frontmatter Guide — YAML Referenz

3 min read

Abstract

Frontmatter ist der YAML-Block am Anfang jeder Notiz (zwischen ---). Quartz liest ihn aus und steuert damit Titel, Tags, Metadaten, Verhalten und Styling der Seite.

📋 Vollständige Feldübersicht

---
# ─── PFLICHTFELDER ───────────────────────────────
title: "Seitentitel"              # Angezeigter Titel (H1)
 
# ─── EMPFOHLENE FELDER ───────────────────────────
description: "Ein Satz Inhalt"   # Meta-Tag, RSS, Hover-Preview
tags: [topic/sub, garden/status] # Navigation & Filterung
aliases: [Alt-Name, Synonym]     # Erzeugt 301-Redirects!
publish: true                    # true | false (default: true)
 
# ─── DATUM & ZEIT ────────────────────────────────
date: 2026-04-21                 # Erstelldatum (ISO 8601)
lastmod: 2026-04-21              # Letztes Update
 
# ─── LAYOUT & STYLING ────────────────────────────
cssclasses: [wide, moc]          # CSS-Klassen auf <article>
draft: false                     # true = wird nicht gebaut!
 
# ─── QUELLE (für Lit-/Research-Notizen) ──────────
author: "Vorname Nachname"
year: 2024
source: "https://..."
type: book                       # book|article|paper|video|podcast
 
# ─── PROJEKT-FELDER ──────────────────────────────
status: active                   # idea|planning|active|paused|done
priority: high                   # low|medium|high
due: 2026-06-01
 
# ─── LEARNING TRACK ──────────────────────────────
skill-level: beginner            # beginner|intermediate|advanced
estimated-hours: 10
---

🔍 Feldbeschreibungen

title

title: "Mein Notiz-Titel"
  • Pflichtfeld — wird als <h1> und Browser-Tab-Titel gerendert
  • Ohne title nimmt Quartz den Dateinamen
  • Empfehlung: max. 60 Zeichen (SEO-freundlich)
  • Erlaubt Emojis: title: "🌱 Meine Notiz"

aliases

aliases: [Alternativname, Anderer Titel, Abkürzung]
  • Erzeugt automatisch 301-Redirects durch AliasRedirects()-Plugin
  • Mit [[Alternativname]] kannst du auf diese Notiz verlinken, auch wenn der Dateiname anders heißt
  • Besonders nützlich für Umbenennungen: alter Name als Alias → keine toten Links

Example

Datei: Quartz.md Alias: Quartz SSG, Digital Garden Generator → [[Quartz SSG]] leitet zu Quartz.md weiter ✅

tags

tags: [topic/lernen, garden/seedling, type/article]
  • Hierarchisch mit /: topic/subtopic/subsubtopic
  • Quartz erstellt automatisch eine /tags/<name>-Seite für jeden Tag
  • Alle Tags auf /tags/ aufgelistet
  • Empfohlene Konventionen:
PräfixVerwendungBeispiele
garden/Reifegradseedling, budding, evergreen
topic/Themengebietlernen, tools, quartz
type/Notiz-Typarticle, daily, moc, decision, research
status/Projektstatusactive, done, paused
lang/Sprachedeutsch, english

description

description: "Ein Satz, der beschreibt worum es geht"
  • Wird für Meta-Description (SEO), RSS-Feed und Hover-Preview genutzt
  • Description()-Plugin extrahiert automatisch den ersten Absatz, wenn kein Feld gesetzt
  • Manuell setzen empfohlen für bessere Kontrolle
  • Empfehlung: max. 160 Zeichen

publish vs. draft

publish: false   # Seite wird NICHT in Output gebaut
draft: true      # Seite wird durch RemoveDrafts() gefiltert

Unterschied:

  • draft: true → wird durch RemoveDrafts()-Plugin entfernt (in Config aktiv)
  • publish: false → ist kein Quartz-Standardfeld, kann aber mit ExplicitPublish()-Filter genutzt werden
  • Einfachste Lösung: draft: true für unveröffentlichte Notizen

Tip

Dateien in content/private/ werden nie gebaut (in ignorePatterns der Config). Kein Frontmatter nötig!

date & lastmod

date: 2026-04-21
lastmod: 2026-04-21
  • Quartz’s CreatedModifiedDate()-Plugin hat Priorität: frontmatter → git → filesystem
  • date = Erstelldatum
  • lastmod / modified = Letztes Update
  • ISO 8601 Format: YYYY-MM-DD
  • Wird in ContentMeta() angezeigt (unter dem Titel)

cssclasses

cssclasses: [wide, moc, no-title]
  • Fügt CSS-Klassen direkt auf <article class="..."> ein
  • Eingebaute Klassen: keine Standard-Quartz-Klassen definiert → du definierst sie selbst in custom.scss
  • Nützliche eigene Klassen: moc, wide, no-sidebar, dark-only

CSS in quartz/styles/custom.scss

article.moc {
  background: var(--highlight);
  border-left: 4px solid var(--secondary);
  padding-left: 1rem;
}
aliases: [Kurztitel, Alternativ]

Wenn du [[Alternativ]] schreibst, leitet Quartz automatisch zu dieser Datei weiter.

Praktisches Beispiel:

Datei: Lit-Ahrens-How-to-Take-Smart-Notes.md
Alias: Smart Notes, Ahrens
→ [[Smart Notes]] funktioniert als Link ✅

🧩 Kombination: Das vollständige Template

Das Minimum für eine gute Notiz:

---
title: "Titel deiner Notiz"
tags: [topic/bereich, garden/seedling]
description: "Ein Satz"
publish: true
---

Das Optimum für eine ausgearbeitete Notiz:

---
title: "Ausgearbeiteter Titel"
aliases: [Alternativ1, Alternativ2]
tags: [type/article, topic/bereich, garden/evergreen]
description: "Präzise Beschreibung für SEO und RSS (max 160 Zeichen)"
date: 2026-04-21
cssclasses: []
publish: true
---

🔗 Verwandte Seiten

Status: 🌳 Evergreen | Referenz für alle Templates

Graph View

Backlinks