# 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.
- URL: https://beckmann.ai/blog/markdown-als-quelle
- Autor: Brian Beckmann
- Veröffentlicht: 2026-05-24
- Tags: 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.txt`** und **`llms-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.