Praxisprojekt Second Brain · Konzepte
Warum Markdown und reiner Text
Lernziele
- Du nennst vier Gründe, warum ein Second Brain aus Markdown-Dateien besteht.
- Du erklärst, warum Git einen Agenten sicher genug für unbeaufsichtigte Läufe macht.
- Du kennst die drei Grenzen von reinem Text, bevor du an sie stößt.
Das Format wirkt wie ein Detail. Es entscheidet, ob das System funktioniert.
Agenten können Dateien besser als APIs
Ein AgentEin System, in dem ein Sprachmodell seinen nächsten Schritt selbst wählt: Es ruft Werkzeuge auf, wertet das Ergebnis aus und macht weiter, bis das Ziel erreicht ist.Im Glossar, der einen Ordner liest, tut, was er am besten kann: Text lesen und Text schreiben. Er muss kein Schema lernen und keine API korrekt aufrufen. Eine Anfrage, die nur halb gelingt, gibt es dabei nicht.
Diese Zuverlässigkeit summiert sich über Tausende Operationen. Eine Pipeline, die Markdown-Dateien schreibt, scheitert so, dass du es in einem Diff siehst. Eine Pipeline, die über eine API schreibt, scheitert so, dass du es erst später merkst.
Portabilität
Jedes Notizwerkzeug, dem Menschen vertraut haben, wurde nach unserer Einschätzung irgendwann eingestellt, teurer oder machte den Export absichtlich mühsam.
Reine Dateien lösen dieses Problem. Dein Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar öffnet sich in jedem Texteditor, synchronisiert mit jedem Werkzeug und funktioniert mit jedem Agenten, der Dateien liest. Du wechselst das Modell, den Editor oder das Betriebssystem, und der Vault bleibt unberührt, weil er nie in einem Programm gesteckt hat.
Hier wiegt das schwerer als sonst. Ein Second Brain sammelt seinen Wert über Jahre. Ein Format, das dich festhält, kostet dich irgendwann das Ganze.
Wikilinks als Graphformat
[[Seitenname]] ist eine Konvention aus zwei Klammerpaaren. Ein Wikilink · engl. wikilinkEin Verweis auf eine andere Seite in doppelten eckigen Klammern, etwa [[Kontextfenster]]. Aus allen Wikilinks eines Vaults entsteht ein Graph.Im Glossar erzeugt einen echten Graphen, bleibt als Text lesbar und übersteht jedes Werkzeug, das ihn nicht kennt. Im schlimmsten Fall stehen eben ein paar Wörter in einem Satz.
Du kannst Wikilinks mit einem regulären Ausdruck auslesen. Genau das tut das Skript scripts/graph_export.py aus dem Werkzeugkasten des Kurses:
LINK = re.compile(r"\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|[^\]]+)?\]\]")Der Ausdruck fängt den Seitennamen ein und überspringt einen Abschnittsanker nach # und einen Anzeigetext nach |. Nach unserer Einschätzung ginge das mit einem proprietären Format für Blockverweise nicht so einfach.
Git funktioniert darauf
Text lässt sich vergleichen. Diese eine Eigenschaft macht einen Agenten sicher genug für unbeaufsichtigte Läufe: Jede Änderung, die er vornimmt, kannst du prüfen, zurücknehmen und einem bestimmten Lauf zuordnen.
Binärformate und Apps mit Datenbank im Hintergrund bieten nichts Vergleichbares. Dort vertraust du der Automatisierung entweder vollständig, oder du automatisierst gar nicht.
Die Grenzen
Reiner Text kann ein paar Dinge schlecht. Wer das übergeht, wird nach unserer Einschätzung früher oder später frustriert.
- Strukturierte Abfragen in großem Umfang. Das Obsidian-Plugin Dataview fragt die Metadaten deiner Seiten ab und deckt viel ab. Ab ein paar tausend Seiten verlangen relationale Fragen eine echte Datenbank. Exportiere dann den Graphen und behalte Markdown, wie im Kapitel Graphen beschrieben.
- Reiche Medien. Bilder liegen als Dateien neben dem Text. Diagramme sind Anhänge.
- Gleichzeitiges Bearbeiten. Schreiben zwei Agenten dieselbe Datei, geraten sie so in Konflikt, wie Dateien eben in Konflikt geraten: schlecht.
Für einen persönlichen Vault wiegt keine dieser Grenzen die Portabilität auf. Kennen solltest du alle drei, bevor du an sie stößt.
Stärke oder Grenze?
Ordne jede Situation zu: Trägt reiner Text hier, oder stößt du an eine seiner Grenzen?
Noch offen (6)
- Ein Agent hat über Nacht 30 Seiten geändert, und du willst sehen, was genau
- Du wechselst von einem Editor zu einem anderen
- Zwei Agenten schreiben gleichzeitig in dieselbe Seite
- Du willst über 5.000 Seiten wissen, welche Personen an welchen Projekten mit welchen Quellen beteiligt sind
- Ein Werkzeug kennt keine Wikilinks und zeigt sie als normalen Text
- Du willst ein Diagramm direkt im Fließtext bearbeiten
Reiner Text trägt (0)
Grenze von reinem Text (0)
Merksätze
- Agenten arbeiten mit Dateien zuverlässiger als über APIs, und Fehler zeigen sich im Diff.
- Reine Dateien gehören dir und überstehen jeden Wechsel von Modell, Editor oder Betriebssystem.
- Wikilinks erzeugen einen Graphen, den ein einfacher regulärer Ausdruck auslesen kann.
- Mit Git ist jede Änderung eines Agenten prüfbar, umkehrbar und einem Lauf zuzuordnen.
- Große relationale Abfragen, reiche Medien und gleichzeitiges Schreiben sind die Grenzen von reinem Text.
Prüf dich selbst
Denkfrage
Warum ist Git die Voraussetzung dafür, einen Agenten nachts allein am Vault arbeiten zu lassen?
Weil jede Änderung als Text-Diff sichtbar wird. Du siehst morgens, was der Lauf geändert hat, kannst einzelne Änderungen zurücknehmen und weißt, welcher Lauf sie verursacht hat. In einer App mit Datenbank hättest du diese Kontrolle nicht.
Denkfrage
Dein Vault hat 4.000 Seiten, und Dataview-Abfragen werden zäh. Gibst du Markdown auf?
Nein. Du exportierst den Graphen in ein Format, das eine Datenbank versteht, und stellst die relationalen Fragen dort. Der Vault bleibt in Markdown und behält seine Portabilität.
Prüf dich selbst