Obsidian, Markdown und YAML

Ausgangslage: Wechsel von Microsoft OneNote zu Markdown

Ein wesentlicher Auslöser für den Einsatz von Obsidian war der Umstieg von Microsoft OneNote auf eine rein dateibasierte Dokumentation im Markdown-Format. Ziel war es, Inhalte langfristig unabhängig von proprietären Formaten zu halten und vollständig im eigenen Dateisystem zu verwalten.

Mit der Umstellung entstanden in relativ kurzer Zeit sehr viele einzelne Markdown-Dokumente. Während OneNote Inhalte innerhalb einer festen Notizbuchstruktur bündelt, verteilt sich Markdown naturgemäß auf einzelne Dateien und Ordner.

In dieser Phase zeigte sich schnell ein Problem: Ohne klare Systematik verliert man bei einer wachsenden Anzahl an Dateien leicht den Überblick. Die inhaltliche Freiheit von Markdown führte zunächst zu einer strukturellen Unübersichtlichkeit.

Arbeiten direkt auf Markdown-Dateien

Obsidian greift direkt auf normale Markdown-Dateien im Dateisystem zu. Es existiert keine Datenbank und kein proprietäres Speicherformat. Alle Inhalte bleiben jederzeit unabhängig lesbar und mit anderen Editoren bearbeitbar.

Das Werkzeug verändert nicht die grundlegende Datenstruktur, sondern bietet eine leistungsfähige Arbeitsoberfläche auf bereits vorhandene Dateien. Dadurch bleibt die Entscheidung für Markdown konsequent umgesetzt.

Strukturgewinn durch Obsidian

Der entscheidende Mehrwert lag nicht in zusätzlichen Funktionen, sondern in der Wiederherstellung von Übersicht. Obsidian ermöglicht eine schnelle Navigation durch große Ordnerstrukturen sowie eine leistungsfähige Suche über Dateiinhalte hinweg.

Verknüpfungen zwischen thematisch zusammenhängenden Dokumenten schaffen zusätzliche Orientierung, ohne die physische Ablage zu verändern. Dadurch entsteht eine zweite, logische Ordnungsebene, die insbesondere bei umfangreichen Beständen hilfreich ist.

YAML als strukturelles Ordnungselement

Ein weiteres zentrales Strukturhilfsmittel ist die Verwendung von YAML-Metadaten innerhalb der Markdown-Dateien. Während Ordner und Dateinamen die äußere Ordnung definieren, ermöglicht YAML eine inhaltliche Klassifikation auf Dokumentebene.

Über definierte Metadatenfelder lassen sich Dokumente eindeutig einordnen, versionieren und kontextualisieren. Diese Informationen bleiben Bestandteil der jeweiligen Datei und sind damit ebenso unabhängig wie der restliche Textinhalt.

YAML schafft eine zusätzliche, systematische Ebene oberhalb der reinen Dateistruktur. Dokumente können dadurch nach Status, Thema oder Funktion unterschieden werden, ohne ihre physische Ablage verändern zu müssen.

In Verbindung mit Obsidian erleichtert diese Metadatenstruktur die Navigation, Filterung und thematische Zuordnung größerer Dokumentbestände erheblich.

Einheitlicher YAML-Standard im Wissensarchiv

Wer Wissen langfristig sichern will, steht früher oder später vor derselben Frage: Wie lassen sich Inhalte so strukturieren, dass sie über Jahre hinweg verständlich, auswertbar und unabhängig von einzelnen Werkzeugen bleiben?

In meinem Wissensarchiv habe ich mich deshalb bewusst für einen festen Metadatenstandard auf Basis von Markdown und YAML entschieden. Dieser Standard beschreibt nicht die Veröffentlichung, sondern die innere Ordnung der Wissensbasis.

Ziel eines festen Metadatenstandards

Ein Wissensarchiv wächst über Zeit. Inhalte entstehen in unterschiedlichen Kontexten, werden ergänzt, überarbeitet oder in neue Systeme überführt. Ohne klare Regeln verliert ein Archiv dabei schnell seine innere Ordnung.

Der YAML-Standard verfolgt deshalb ein klares Ziel: Inhalte sollen langfristig eindeutig eingeordnet werden können, Bedeutung und Struktur bleiben getrennt, und spätere Migrationen sollen ohne Neuinterpretation möglich bleiben.

YAML dient dabei nicht der Automatisierung, sondern der Stabilisierung. Die Metadaten beschreiben, was ein Dokument ist und wofür es steht, nicht was ein bestimmtes Programm daraus macht.

Grundprinzipien des Standards

Der Metadatenstandard folgt bewusst einfachen, aber strikten Regeln. Metadaten sind Teil des Dokuments, werden manuell gepflegt und erhalten keine automatisch erzeugten Felder. Bedeutungen werden nicht abgeleitet oder geraten.

Jedes Feld hat eine feste, unveränderliche Bedeutung. Neue Felder entstehen nicht bei Gelegenheit, sondern nur durch bewusste konzeptionelle Entscheidungen. Diese Zurückhaltung ist kein Nachteil, sondern ein Schutzmechanismus.

Sie verhindert, dass sich technische Bequemlichkeit in die Wissensstruktur einschleicht. Weniger Felder bedeuten hier mehr Stabilität.

Trennung von Wissensarchiv und Veröffentlichung

Ein zentraler Bestandteil meines Workflows ist die klare Trennung zwischen Wissensbasis und Veröffentlichung. Das Wissensarchiv ist die führende Instanz. Hier entstehen Inhalte, hier werden sie eingeordnet und hier behalten sie ihre langfristige Bedeutung.

Die Website ist dagegen eine reine Präsentationsschicht. Sie zeigt ausgewählte Inhalte öffentlich an, ohne deren Struktur zu bestimmen. Es gibt keine Rückpflege aus der Veröffentlichung in das Archiv.

Diese Trennung hat einen entscheidenden Vorteil: Das Wissensarchiv bleibt stabil, auch wenn sich das Veröffentlichungsmedium ändert.

Warum bewusst auf Automatiken verzichtet wird

Automatische Metadaten wirken auf den ersten Blick bequem. In der Praxis werden sie jedoch schnell zur Fehlerquelle. Zeitpunkte, Statuswechsel oder abgeleitete Informationen müssten später korrigiert oder synchronisiert werden.

Der Standard enthält daher nur Felder, die dauerhaft gültig bleiben. Alles, was später angepasst werden müsste, gehört nicht in die Metadaten.

Bewusste Abgrenzung von klassischen Notizsystemen

Im Gegensatz zu OneNote speichert Obsidian Inhalte nicht in einer geschlossenen Containerstruktur. Jede Datei bleibt einzeln zugänglich. Diese Offenheit erfordert anfangs mehr Disziplin, bietet langfristig jedoch größere Unabhängigkeit und Transparenz.

Die anfängliche Phase des Verlaufens in vielen einzelnen Markdown-Dateien war daher weniger ein technisches Problem als eine Frage der Struktur. Mit klar definierten Ablageprinzipien und ergänzender Metadatenstruktur wurde Obsidian zum stabilisierenden Element des Workflows.

Keine Veröffentlichung aus Obsidian heraus

Obsidian wird nicht als Publishing-Werkzeug eingesetzt. Es existiert keine automatische Veröffentlichung und keine direkte Kopplung an das Blog. Die Trennung zwischen Arbeitsumgebung und öffentlicher Darstellung bleibt bewusst erhalten.

Langfristige Perspektive

Die Kombination aus Markdown, YAML und Obsidian verbindet Offenheit mit organisatorischer Klarheit. Inhalte bleiben als einfache Textdateien dauerhaft nutzbar, während strukturierende Metadaten und eine leistungsfähige Arbeitsoberfläche die Übersicht bei großen Dokumentbeständen sichern.

Der eigentliche Wert liegt nicht im Werkzeug selbst, sondern in der disziplinierten Strukturierung und Pflege der Dokumente.