Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Markdown-basierte Dokumentation
Übergeordnete Kategorie: Docs-as-Code
Textbasierte Bücher und Portale mit überschaubarer Autorenoberfläche.
Open-Source-Auswahl nach Reifegrad
5 Einträge: für den jeweils beschriebenen Speicherumfang ausgewählt.
Redaktioneller Stand: 27. September 2026; Bewertungskriterien und Grenzen gelten auch hier. Die Rangfolge priorisiert Reife und danach die Passung zum Thema.
| Rang | Software und offizielle Quelle | Lizenz des betrachteten Kerns | Reifegrad | Begründung | Passender Speicherweg und Nachweis |
|---|---|---|---|---|---|
| 1 | MkDocs | BSD-2-Clause | Sehr hoch | Etablierter Markdown-Generator mit zentraler Konfiguration. | Dateien: Markdown-Dateien und YAML-Konfiguration |
| 2 | Jekyll | MIT | Sehr hoch | Langjähriger Generator mit dokumentiertem Ruby-Ökosystem. | Dateien: Markdown-/HTML-Dateien und Templates |
| 3 | Hugo | Apache-2.0 | Sehr hoch | Umfangreiche Dokumentation, Templates und Taxonomien. | Dateien: Inhaltsdateien und Templates |
| 4 | mdBook | MPL-2.0 | Hoch | Fokussierter Generator mit Benutzerhandbuch. | Dateien: Markdown- und HTML-Dateien |
| 5 | Docusaurus | MIT | Hoch | Dokumentiertes Framework und Sicherheitsrichtlinie. | Dateien: Markdown-/MDX-Dateien |
Einsatz und Abgrenzung
Die Konfiguration unterscheidet sich: YAML ist verbreitet, aber keine Voraussetzung. mdBook verwendet TOML und SUMMARY.md.
- MkDocs: Setzt auf Python-Markdown mit solider CommonMark-Konformität; Navigationsbäume werden deklarativ über eine zentrale Konfigurationsdatei gesteuert.
- Jekyll: Etablierter Markdown-Standard im Git-Umfeld via Kramdown-Parser und Liquid-Templating; native Ausführung auf GitHub Pages.
- Hugo: Bietet durch den integrierten Goldmark-Compiler herausragende Generierungsgeschwindigkeit für sehr große Markdown-Bestände.
- mdBook: Konzentriert sich auf reines Markdown ohne komplexe Frontend-Toolchains; die Leseführung wird strikt über die Inhaltsdatei
SUMMARY.mddefiniert. - Docusaurus: Erweitert Markdown-Dateien zu MDX, wodurch React-Komponenten direkt im Textfluss eingebunden werden können.