adoc Studio vs Docusaurus
Docusaurus
Open-Source Static Site Generator von Meta, basiert auf React und Markdown/MDX. Beliebt bei Entwicklerteams für Produkt- und API-Dokumentation als Website.
adoc Studio
Spezialisierte Schreib-App für AsciiDoc. Native Mac-, iPad- und iPhone-Erfahrung mit Live-Vorschau, PDF-Export und integriertem Website-Generator.
Feature-Vergleich
| Funktion | Docusaurus | adoc Studio |
|---|---|---|
| Lizenzkosten | ★ Open Source, kostenlos nutzbar | Community Edition kostenlos, Pro Edition mit Abo |
| Anpassbarkeit der Website | ★ Volle React-Anpassung über Themes und Plugins | CSS-basierte Themes und Layouts ohne Code |
| Plattformen | Browser, erfordert lokale Build-Umgebung | ★ Native App für Mac, iPad und iPhone |
| Einstieg ohne Entwicklerwissen | Node.js, npm und React-Kenntnisse nötig | ★ Installieren, schreiben, exportieren ohne Toolchain |
| PDF-Export | Kein nativer PDF-Export, Drittanbieter-Plugins nötig | ★ Eingebauter PDF-Export inklusive PDF/UA-Konformität |
| Live-Vorschau | Hot-Reload im Dev-Server, kein dedizierter Editor | ★ Sofortige WYSIWYG-Vorschau direkt im Editor |
| Strukturiertes Authoring | Markdown plus MDX-Erweiterungen | ★ AsciiDoc mit Includes, Variablen und Bedingungen |
Markdown plus React: Docusaurus kombiniert Markdown mit MDX, sodass React-Komponenten in Inhalte eingebettet werden können. Das ist mächtig, setzt aber Frontend-Wissen voraus und vermischt Inhalt mit Code.
AsciiDoc als Standard: adoc Studio bietet ein vollwertiges AsciiDoc-Editing mit Includes, Attributen und Bedingungen. Die Markup-Sprache ist lesbar, strukturiert und unabhängig von einem bestimmten Framework.
Build-orientiert: Eine Docusaurus-Site benötigt Node.js, npm und einen lokalen Build-Schritt. Anpassungen erfolgen über React-Komponenten und Konfigurationsdateien. Ideal für Teams mit Entwicklerressourcen.
One-Click-Export: adoc Studio exportiert das gesamte Projekt mit einem Klick als statische Website. Keine Build-Tools, keine npm-Abhängigkeiten. Mehrsprachigkeit, Navigation und Suche sind eingebaut.
Web-first: Docusaurus ist auf HTML-Output ausgelegt. PDF-Export erfordert externe Werkzeuge wie Pandoc oder Browser-Druckskripte. Barrierefreie PDF/UA-Ausgabe ist nicht vorgesehen.
PDF nativ und barrierefrei: PDF-Export ist Teil der App. Mit dem PDF/UA-Modus erfüllen Sie die Anforderungen des Barrierefreiheitsstärkungsgesetzes ohne zusätzliche Werkzeuge.
Entwicklerteams: Docusaurus ist Standard in vielen Open-Source-Projekten und passt zu Teams mit Frontend-Erfahrung. Inhalte und Themes leben im Git-Repository neben dem Code.
Technische Redaktionen: adoc Studio richtet sich an technische Autorinnen und Autoren, die strukturiert schreiben wollen, ohne erst eine Toolchain aufzubauen. Git wird unterstützt, ist aber keine Voraussetzung.
Wann welches Tool wählen?
Docusaurus für...
- Open-Source-Projekte mit Entwicklerressourcen
- Stark angepasste Marketing- oder Produktwebsites
- React- und MDX-basierte Komponenten in Dokumenten
- Etablierte Node.js- und Frontend-Workflows
- Teams ohne PDF-Ausgabeanforderungen
Ideal für:
- Open-Source-Projekt-Sites
- Entwicklerportale mit Markenanpassung
- API-Dokumentation in Dev-Teams
- Versionierte Software-Dokumentation
adoc Studio für...
- Native Apple-Umgebung statt Build-Server
- Strukturierte technische Dokumentation in AsciiDoc
- PDF- und Website-Export aus einer App
- PDF/UA-Konformität für regulierte Inhalte
- Autorinnen und Autoren ohne Frontend-Erfahrung
Ideal für:
- Produktdokumentation und Handbücher
- Mehrsprachige technische Inhalte
- Behörden- und Compliance-Dokumente
- Onboarding- und Schulungsmaterial
Von Docusaurus zu adoc Studio
Die Migration von Docusaurus zu adoc Studio bedeutet, vom Build-Server zur fokussierten Schreib-App zu wechseln. Bestehende Markdown-Inhalte lassen sich nach AsciiDoc konvertieren und behalten ihre Struktur.
Inhalte sichten
Listen Sie Ihre bestehenden Docusaurus-Inhalte auf. Identifizieren Sie MDX-Komponenten, Versionierung und Sidebar-Konfiguration. Markieren Sie Inhalte, die als reines Markup übernommen werden können.
Markdown nach AsciiDoc konvertieren
Nutzen Sie Pandoc für die Konvertierung der Markdown-Dateien:
pandoc docs/intro.md -f markdown -t asciidoc -o intro.adoc --wrap=nonePrüfen Sie das Ergebnis, da MDX-Komponenten in AsciiDoc-Äquivalente überführt werden müssen.
Struktur in adoc Studio aufbauen
Legen Sie ein neues Projekt an und übernehmen Sie die bisherige Sidebar als AsciiDoc-Master-Dokument mit Includes. Variablen und Konfigurationswerte werden zu AsciiDoc-Attributen.
Theme und CSS übertragen
Ersetzen Sie das Docusaurus-Theme durch ein adoc Studio Theme. CSS-Regeln können weitgehend übernommen werden. Passen Sie Farben, Schriftarten und Abstände in der Live-Vorschau an.
Website und PDF exportieren
Exportieren Sie das Projekt als statische Website. Optional erzeugen Sie zusätzlich ein PDF oder PDF/UA-Dokument aus demselben Quelltext. Beide Ausgaben bleiben jederzeit synchron.
Deployment einrichten
Laden Sie den Export-Ordner auf Ihren Webserver oder in ein Git-Repository. Eine Build-Pipeline ist nicht zwingend nötig, lässt sich bei Bedarf aber weiterhin nutzen.
Häufig gestellte Fragen
Ist adoc Studio so flexibel wie Docusaurus?
adoc Studio ist auf strukturiertes Schreiben und schnelles Publishing fokussiert. Wer eine vollständig in React anpassbare Website benötigt, ist mit Docusaurus weiterhin gut bedient. Für klassische technische Dokumentation deckt adoc Studio die meisten Anforderungen ohne Code ab.
Kann ich meine MDX-Komponenten übernehmen?
MDX-Komponenten enthalten React-Code und lassen sich nicht direkt nach AsciiDoc übertragen. Häufig verwendete Komponenten wie Hinweisboxen, Tabs oder Codeblöcke sind in AsciiDoc als native Konstrukte verfügbar.
Brauche ich weiterhin Node.js?
Nein. adoc Studio ist eine native App und benötigt weder Node.js noch npm. Sie schreiben, sehen die Vorschau und exportieren direkt aus der App.
Wie sieht es mit Versionierung aus?
adoc Studio unterstützt Git als externes Versionsverwaltungssystem. Sie können dieselben Branching- und Review-Workflows nutzen wie zuvor in Docusaurus.
Wie barrierefrei ist der PDF-Export?
adoc Studio erzeugt PDF/UA-konforme Dokumente nach ISO 14289. Damit erfüllen Sie die Vorgaben des Barrierefreiheitsstärkungsgesetzes ohne externe Prüf- oder Konvertierungstools.
Weitere Vergleiche
vs
P
Download