Markdown als Datenbank

Für eine persönliche Website ersetzt ein Ordner mit Markdown-Dateien und strukturiertem Kopf die Datenbank, solange ein Schema ihn prüft.

Artikel Erstellt Aktualisiert Auch auf Englisch: Markdown as a Database

Geprüft von adrian am

Eine Datenbank macht drei Dinge: Sie speichert Datensätze, erzwingt ihre Form und beantwortet Abfragen. Ein Ordner mit Markdown-Dateien schafft alle drei, mit etwas Hilfe.

Speichern

Jede Datei ist ein Datensatz. Der Dateiname ist der Schlüssel, der Frontmatter hält die Felder und der Text darunter den Inhalt.

Form erzwingen

Das unterscheidet einen Haufen Notizen von einem Datenbestand. Hier prüft kb check jede Datei gegen ein Schema und die Ontologie, jede Beziehung eingeschlossen. Ein Verweis, der ins Leere führt, wird als Fehler gemeldet.1 Die Website liest die Dateien nur und schreibt sie nie.2

Abfragen

Bei ein paar tausend Dateien reicht es, alles einmal zu lesen und im Speicher zu halten. Diese Website liest die Dateien beim Start und erneut innerhalb von Sekunden, wenn sich eine ändert.2 Erst weit darüber lohnt sich eine echte Datenbank, und selbst dann bleiben die Dateien die Quelle.


  1. Das Werkzeug kb und seine Prüfungen (gespeicherter Chat). ↩

  2. Die Website auf FastAPI (gespeicherter Chat). ↩

Beruht auf

  • Moving the knowledge base out of the website project (raw/2026/2026-11-14/moving-the-knowledge-base-out-of-the-website-project.md) [kb-tool]
  • The website on FastAPI and a fixed graph structure (raw/2026/2026-11-14/the-website-on-fastapi-and-a-fixed-graph-structure.md) [website]

Mehr dazu

Thema

  • Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.

Baut auf

  • Markdown Einfache Auszeichnungssprache für Text. Dateien bleiben ohne besondere Software lesbar und lassen sich in HTML umwandeln.

Siehe auch

  • Wie ein LLM-Wiki funktioniert Wie ein LLM-Wiki funktioniert, am Beispiel dieser Wissensdatenbank: Markdown in einem eigenen Git-Repository, ein Python-Tool mit MCP für Agenten und eine Website, die nur anzeigt.

In der Graph-Ansicht zeigen