Markdown als Single Source of Truth
Warum content-zentrierte Architekturen mit Markdown die beste Grundlage für Websites sind, die sowohl für Menschen als auch für LLMs optimiert sind.
- Markdown
- Content Collections
- Architektur
Die zentrale Designentscheidung dieses Blogs: Der Inhalt lebt als Markdown, nicht als HTML oder als Datensatz in einer Datenbank. Aus dieser einen Quelle werden alle Ausgabeformate abgeleitet.
Ein Inhalt, viele Formate
Aus jeder Markdown-Datei entstehen:
- eine semantische HTML-Seite für Menschen und Suchmaschinen,
- ein Roh-Markdown-Endpunkt (
.md) für Sprachmodelle, - ein Eintrag in
llms.txtundllms-full.txt, - ein Item im RSS-Feed und in der Sitemap.
Weil alles aus derselben Datei generiert wird, können die Formate nicht auseinanderdriften.
Typsicherheit durch Schema
Astros Content Collections validieren jede Frontmatter gegen ein Zod-Schema. Fehlt ein Pflichtfeld oder hat ein Datum das falsche Format, schlägt der Build fehl – nicht erst die Produktion. Das hält die Metadaten, auf die LLMs sich verlassen, verlässlich sauber.
Weniger Magie, mehr Determinismus
Statische Generierung bedeutet: Was der Crawler sieht, ist exakt das, was im Build erzeugt wurde. Kein clientseitiges Rendering, keine Hydration-Lücken, keine Inhalte, die erst nach JavaScript-Ausführung erscheinen. Für KI-Systeme, die HTML oft ohne JavaScript-Engine verarbeiten, ist das entscheidend.