Quartz 4

🔗 Wikilinks & Backlinks — Linking Guide

3 min read

Abstract

Wikilinks sind das Herzstück eines Digital Gardens. Mit [[...]] verbindest du Notizen bidirektional — jeder Link erzeugt automatisch einen Backlink auf der Zielseite. Dieses Dokument zeigt alle Varianten und Patterns.

🔤 Wikilink-Syntax — Alle Varianten

[[Notiz-Name]]

→ Verlinkt zur Datei Notiz-Name.md im Content-Ordner. → Quartz nutzt Shortest-Path-Resolution: Du musst nicht den vollen Pfad angeben.

Example

[[Zettelkasten-Prinzip]] → verlinkt zu Zettelkasten-Prinzip.md ✅ [[daily/2026-04-21]] → verlinkt tief in Unterordner (optional)

2. Link mit Custom-Text

[[Notiz-Name|Angezeigter Text]]

Example

[[Zettelkasten-Prinzip|Luhmanns System]] → zeigt “Luhmanns System”, verlinkt zu Zettelkasten-Prinzip.md [[01-atomic-note|mehr dazu]] → “mehr dazu” als Linktext

[[Notiz-Name#überschrift|Überschrift]]

Springt direkt zur Sektion. Quartz generiert aus Überschriften automatisch Anker-IDs.

Example

[[callout-showcase#foldable-callouts|Foldable Callouts]] → springt direkt zur Sektion [[frontmatter-guide#aliases|aliases]] → springt zu aliases-Sektion

# Mit Custom-Text
[[Notiz-Name#überschrift|Angezeigter Text]]
[[Notiz-Name#^block-id|^block-id]]

Block-IDs ermöglichen das Verlinken auf einzelne Absätze — granularer als Überschriften.

Block-ID erstellen:

Das ist ein wichtiger Absatz, den ich referenzieren will. ^wichtiger-absatz

Block-ID referenzieren:

[[Notiz-Name#^wichtiger-absatz|^wichtiger-absatz]]
[[Notiz-Name#^wichtiger-absatz|Eigener Text]]

Tip

Block-IDs müssen eindeutig in der Datei sein. Nutze beschreibende Namen: ^luhmann-kernthese, nicht ^1.

5. Embed — Ganze Notiz einbetten

![[Notiz-Name]]

Der gesamte Inhalt der Notiz wird an dieser Stelle eingefügt.

Example

Hier ist das Zettelkasten-Prinzip eingebettet:
 
![[Zettelkasten-Prinzip]]

6. Embed — Sektion einbetten

![[Notiz-Name#überschrift|Überschrift]]

Nur der Inhalt ab der Überschrift bis zur nächsten gleichwertigen wird eingebettet.

7. Embed — Block einbetten

![[Notiz-Name#^block-id|^block-id]]

Nur der spezifische Block wird eingebettet — präziseste Form der Transclusion.

8. Bild einbetten (mit Größe)

![[bild.png]]
![[bild.png|300]]          → 300px breit
![[bild.png|300x200]]      → 300x200px
![[bild.png|center]]       → zentriert (mit CSS)

📊 Übersichtstabelle

SyntaxErgebnisNutzen
[[Note]]LinkEinfache Verlinkung
[[Note|Text]]Link mit TextCustom Linktext
[[Note\#Section]]Link zu SektionPräzise Navigation
[[Note\#^block]]Link zu BlockGranulare Referenz
![[Note]]Embed (ganz)Inhalt einbinden
![[Note\#Section]]Embed (Sektion)Teilinhalt einbinden
![[Note\#^block]]Embed (Block)Block einbinden
![[img.png|300]]Bild (skaliert)Bilder einbinden

↩️ Backlinks — Automatische Bidirektionalität

Backlinks entstehen automatisch. Wenn du [[Zettelkasten-Prinzip]] schreibst:

  1. Auf der Zielseite Zettelkasten-Prinzip.md erscheint diese Notiz unter “Backlinks”
  2. Du musst nichts manuell eintragen
  3. Der Knowledge-Graph zeigt die Verbindung visuell

Das Backlinks()-Komponente ist in quartz.layout.ts in der rechten Spalte konfiguriert:

right: [
  Component.Graph(),
  Component.DesktopOnly(Component.TableOfContents()),
  Component.Backlinks(),   // ← hier
]
graph LR
    A[Notiz A] -->|"[[B]]"| B[Notiz B]
    C[Notiz C] -->|"[[B]]"| B
    D[Notiz D] -->|"[[B]]"| B

    B -.->|"Backlinks zeigen:"| E["A, C, D"]

Nutzen:

  • Notiz B sieht, wer sie referenziert (ohne es selbst zu wissen)
  • Tagesnotiz [[2026-04-21]] erscheint als Backlink in [[Projekt-...]]
  • Literaturnotizen erscheinen als Backlinks in Konzept-Notizen

🕸️ Der Knowledge-Graph

Der Graph (rechts oben) visualisiert alle Verbindungen:

  • Knoten = Notizen
  • Kanten = [[Wikilinks]]
  • Klicken auf Knoten → öffnet die Notiz
  • Hover über Knoten → zeigt Verbindungen

Graph-Tipps

  • Notizen ohne Links sind isolierte Inseln im Graph → immer verlinken!
  • MOCs werden zu Hubs (viele Verbindungen) — das ist gewünscht
  • index.md sollte der zentralste Knoten sein

💡 Hover-Preview (Popover)

enablePopovers: true ist aktiv — hover über jeden Wikilink und siehst eine Vorschau der verlinkten Notiz, ohne die Seite zu verlassen.

Die Vorschau zeigt:

  • title aus Frontmatter
  • description aus Frontmatter (oder ersten Absatz)
  • Tags

🔍 Link-Resolution: Shortest Path

CrawlLinks({ markdownLinkResolution: "shortest" }) bedeutet:

content/
├── tools/
│   └── Quartz.md
└── garden/
    └── Quartz.md   ← Konflikt!

Bei Konflikten: vollständigen Pfad angeben:

[[tools/Quartz]]   oder   [[garden/Quartz]]

Bei eindeutigen Namen: Dateiname reicht:

[[Zettelkasten-Prinzip]]   ✅  (nur einmal vorhanden)

🌱 Verwandte Seiten

Status: 🌳 Evergreen | Vollständige Linking-Referenz

Graph View

Backlinks