Docusaurus
Open-Source-Generator für statische Dokumentationswebsites, veröffentlicht von Meta
Docusaurus ist ein quelloffener Generator für statische Websites von Meta, MIT-lizenziert, zum Aufbau und zur Pflege von Dokumentationswebsites. Ein einziger Befehl erzeugt eine React-basierte Website, die bereits einen versionierten Dokumentationsbereich, einen Blog, eigenständige Seiten und ein Theme mitbringt, und das Repository liefert gepflegte Plugins für Sitemaps, Algolia-Suche, Übersetzungen, Weiterleitungen und Analytics-Tags. Es hat 65.749 Sterne, Stand Juli 2026. Für Gründerinnen und Gründer eines Entwicklerwerkzeugs entfällt damit der Aufwand, eine Doku-Website zu bauen — was etwas anderes ist, als dass jemand kommt und sie liest.
Was Docusaurus ist
Docusaurus (github.com/facebook/docusaurus) beschreibt sich als Projekt, mit dem sich Websites für Open-Source-Projekte leicht bauen, ausliefern und pflegen lassen. Praktisch ist es ein React-basierter Generator für statische Websites, in dem Dokumentation der Bürger erster Klasse ist: Ein Befehl, npm init docusaurus@latest, erzeugt eine Website, die Dokumentationsbereich, Blog, eigenständige Seiten und ein Theme bereits enthält, sodass der erste Tag dem Schreiben gehört und nicht dem Zusammenstecken eines Stacks. Meta hat es veröffentlicht, weil es hilft, über die vielen eigenen Open-Source-Projekte hinweg zu skalieren. Der Code ist MIT-lizenziert, die Dokumentationsinhalte im Repository tragen eine gesonderte Creative-Commons-Lizenz.
- Inhaltstypen sind eigene Plugins — das Repository liefert getrennte hauseigene Pakete für Dokumentation, für einen Blog und für eigenständige Seiten. Eine Website kann also reine Dokumentation sein, Dokumentation plus Changelog, oder eine vollständige Website mit Marketing-Startseite, ohne ein zweites Werkzeug hinzuzunehmen.
- Die Teile, die man sonst anflanscht, sind schon da — Sitemap-Erzeugung, Algolia-gestützte Suche, clientseitige Weiterleitungen für verschobene URLs, Übersetzungen, PWA-Unterstützung, Mermaid-Diagramme, Bildoptimierung und Google-Analytics-Tags existieren als gepflegte Pakete im selben Repository.
- Geschrieben wird in MDX — Seiten sind Markdown, in das sich React-Komponenten einbetten lassen. Genau das macht einen ausführbaren Codeblock oder ein interaktives Beispiel in einer Seite möglich, die ansonsten nur eine Datei in deinem Repository ist.
Dokumentation, Blog und Marketingseite sind drei verschiedene Aufgaben
Der häufigste Weg, eine Doku-Website zu verschwenden, besteht darin, sie als eine weitere Inhaltsfläche zu behandeln und alles an derselben Zahl zu messen. Diese drei Flächen ziehen unterschiedliche Menschen an, die in unterschiedlichen Zuständen ankommen, und nur eine von ihnen versucht, von jemandem gefunden zu werden, der noch nie von dir gehört hat.
| Fläche | Wer ankommt | Was sie kann und was nicht |
|---|---|---|
| Dokumentation | Jemand, der das Produkt schon nutzt oder prüft, ob es eine bestimmte Sache kann | Nimmt Zweifel und löst Blockaden beim Einrichten. Erzeugt selten Nachfrage von allein, ist aber der Ort, an dem aus einem Vielleicht ein Ja wird |
| Blog oder Changelog | Jemand, der ein Problem sucht, oder ein Bestandsnutzer, der schaut, was neu ist | Kann neue Besucher bringen und Bestandsnutzern einen Grund zur Rückkehr geben. Braucht einen Daseinszweck jenseits von Release Notes |
| Marketing-Startseite | Jemand, der erst entscheidet, ob ihn das überhaupt betrifft | Rahmt das Produkt für Fremde. Dokumentation kann diese Aufgabe nicht übernehmen, und wenn sie es versucht, liest sie sich wie eine Bedienungsanleitung |
Docusaurus beherbergt gern alle drei, und darin liegt die Falle: Weil sie in einem Build erscheinen, werden sie als eine Sache bewertet. Trenne zuerst die Auswertung — eine Doku-Seite und eine Landingpage sehen in einer Traffic-Tabelle identisch aus und beantworten völlig verschiedene Fragen. Wenn die publizistische Hälfte die eigentliche Arbeit ist, ist Ghost dafür gebaut; wenn die Inhalte eine Redaktionsoberfläche für Menschen brauchen, die keine Pull Requests öffnen, ist das Payload.
Wo eine Doku-Website in den Wachstumsstack gehört
Dokumentation ist der Inhalt mit der höchsten Kaufabsicht, den die meisten Entwicklerwerkzeuge besitzen, und zugleich der am verlässlichsten vernachlässigte. Sie rankt auch, bei einer bestimmten Art von Anfrage: Entwickler suchen nach Fehlermeldungen, nach API- und Funktionsnamen und nach Formulierungen der Art, wie man diese eine Sache in diesem einen Werkzeug macht. Diese Anfragen sind wenig umkämpft und stark intentional, und eine präzise Antwort gewinnt sie ohne den Aufwand, den ein umkämpfter Hauptbegriff verlangt. Das ist eine echte Akquisitionsfläche, aber eine schmale, denn fast jede dieser Anfragen enthält bereits deinen Produktnamen oder ein Problem, das dein Produkt erzeugt hat. Dokumentation verstärkt, was du hast, statt es zu beginnen. Wie man die Aufmerksamkeit überhaupt gewinnt, steht in wie vermarkte ich ein Entwicklerwerkzeug, und ein Thema statt einer Seite zu besitzen, ist thematische Autorität.
Aus erster Hand beim Bau von AgentCeres — dem AI Growth Officer auf agentceres.com: Womit wir nicht gerechnet hatten, ist, dass eine Doku-Seite und eine Marketingseite im Analytics-Bericht identisch aussehen und dabei entgegengesetzte Aufgaben erfüllen. Die eine liest jemand, der entscheidet; die andere jemand, der bereits entschieden hat und nun feststeckt. Aufgefallen ist es uns nur, weil die Fragen, die im Chat unseres eigenen Produkts eintrafen, fast zeilengenau die Überschriften waren, die unsere Dokumentation hätte haben müssen. Ein Support-Verlauf ist ein besseres Inhaltsverzeichnis als jedes Keyword-Werkzeug, weil er eine Liste genau jener Stellen ist, an denen das Produkt aufhörte, offensichtlich zu sein — sortiert danach, wie oft Menschen dort landen. Wenn du diese Woche Docusaurus installierst, ist die wertvollste erste Seite nicht die Funktionstour. Es ist die Antwort auf die Frage, die du inzwischen dreimal von Hand getippt hast.
FAQ
- Ist Docusaurus kostenlos?
- Das Repository gibt an, dass Docusaurus MIT-lizenziert ist, während die Dokumentationsinhalte im Repo unter einer gesonderten Creative-Commons-Lizenz stehen. Es gibt keine Bezahlstufe, denn erzeugt werden statische Dateien, die du hostest, wo du willst — die Kosten sind also die des gewählten Hostings, bei einer statischen Website oft gar keine. Prüfe die LICENSE-Dateien der Version, die du installierst, denn Lizenzen ändern sich unabhängig von jedem Text darüber.
- Docusaurus oder ein allgemeines Web-Framework?
- Ist die Website überwiegend Dokumentation, gewinnt das spezialisierte Werkzeug, weil versionierte Docs, Seitenleisten, Suche und eine dokumentationsförmige Informationsarchitektur bereits gelöst sind und du sie sonst nachbaust. Ist Dokumentation dagegen ein Abschnitt einer Marketing-Website mit hohen Designansprüchen, gewinnt meist ein allgemeines Framework plus eine Inhaltsschicht, weil du sonst deine Zeit mit einem Theme verbringst, das um einen anderen Schwerpunkt herum gebaut wurde. Die Frage ist, wofür die Website überwiegend da ist.
- Helfen Doku-Websites wirklich beim SEO?
- Sie können es, bei einer bestimmten Klasse von Anfragen: Fehlermeldungen, API- und Funktionsnamen, Integrationsfragen und Wie-mache-ich-Formulierungen, die dein Werkzeug beim Namen nennen. Diese sind wenig umkämpft und stark intentional, und eine präzise Antwort gewinnt sie auch ohne große Domain-Autorität. Was Dokumentation nicht kann, ist für die breiten Kategoriebegriffe zu ranken, die Menschen erreichen, die noch nie von dir gehört haben. Dieser Traffic muss anderswo verdient werden.
- Sollte ich den eingebauten Blog aktivieren?
- Nur wenn du ihn wirklich nutzt. Ein Changelog ist ein guter Standard: Er hat von Natur aus Material und gibt zurückkehrenden Nutzern einen Grund wiederzukommen. Ein Marketing-Blog ist eine größere Verpflichtung, als er aussieht, und ein verlassener mit drei Beiträgen von vor achtzehn Monaten liest sich schlechter als gar kein Blog. Fang mit dem Changelog an und ergänze den Blog, wenn du einen konkreten Satz Fragen hast, den du beantworten willst.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.