GitBook ist eine der beliebtesten Dokumentationsplattformen für Entwicklerteams. Es bietet einen ausgefeilten Editor, solide Kollaborationsfunktionen und ansprechend aussehende veröffentlichte Docs.
Wir haben Valoryx entwickelt, um Probleme zu lösen, die GitBook nicht adressiert — in erster Linie in Bezug auf git-Eigentümerschaft, Self-Hosting und Preistransparenz. Hier ist, wo jedes Tool glänzt und wo jedes an seine Grenzen stößt.
Editor-Erfahrung
GitBook hat einen hervorragenden Web-Editor. Block-basiert, sauber, responsiv. Unterstützt Markdown-Shortcuts, Code-Blöcke, Tabellen, Einbettungen. Kollaborationsfunktionen sind gut durchdacht.
Valoryx verwendet einen Tiptap-basierten WYSIWYG-Editor, der sauberes Markdown ausgibt. Unterstützt Markdown-Kürzel, Code-Blöcke mit Syntax-Highlighting, Tabellen, Hinweise, Bild-Einbettungen. Für Geschwindigkeit optimiert.
Fazit: GitBooks Editor ist heute ausgereifter. Valoryx’ Editor ist schneller und produziert saubereres Markdown.
Git-Integration
GitBook bietet “Git Sync” an, ist aber nicht wirklich bidirektional — das Pushen von Änderungen aus einer IDE verursacht häufig Merge-Konflikte. Das git-Repository ist nicht die Quelle der Wahrheit; GitBooks interner Speicher ist es.
Valoryx ist von Grund auf auf git aufgebaut. Die Dokumentation IST ein git-Repository. Der Content Ledger stellt sicher, dass gleichzeitige Bearbeitungen aus der Web-UI und git nie in Konflikt geraten.
Fazit: Wenn git-Integration wichtig ist, ist Valoryx deutlich besser.
Self-Hosting
GitBook ist nur in der Cloud verfügbar. Keine Self-Hosted-Option.
Valoryx ist eine einzelne Go-Binary ohne externe Abhängigkeiten. Funktioniert unter Linux, macOS, Windows, Docker. Alle Daten verbleiben auf dem eigenen Server. Kein Telemetrie, keine Lizenzschlüssel-Validierung.
Fazit: Wer Self-Hosting benötigt, hat mit Valoryx die einzige Option.
Preisgestaltung
GitBook: Kostenlose Stufe für persönliche/Open-Source-Nutzung. Team-Plan $6,70/Nutzer/Monat. Business: individuelle Preise.
Valoryx:
- Community (dauerhaft kostenlos): self-hosted, unbegrenzte Editoren, volles Funktionspaket
- Team ($29/Workspace/Monat): unbegrenzte Editoren, eigene Domains
- Business ($79/Workspace/Monat): SSO/SAML, Audit-Logs, SLA
Fazit: Für kleine Teams (≤5) ist Valoryx kostenlos und voll ausgestattet. Für größere Teams schlägt die Preis-pro-Workspace-Struktur den Preis pro Nutzer.
Veröffentlichte Dokumentationsseiten
Beide produzieren professionelle Docs mit eigenen Domains, Versionierung und Suche. GitBook hat heute mehr visuellen Glanz; Valoryx konzentriert sich auf Performance und Suchqualität (SQLite FTS5).
Wann sollte man GitBook wählen
- Das Team bearbeitet Docs ausschließlich in der Web-UI
- Ausgereifte Kollaborationsfunktionen werden heute benötigt
- Self-Hosting ist nicht erforderlich
- Ein etabliertes Produkt wird bevorzugt
Wann sollte man Valoryx wählen
- git-Eigentümerschaft ist wichtig
- Entwickler bearbeiten Docs in ihrer IDE zusammen mit dem Code
- Self-Hosting ist aus Compliance- oder Datenhaltungsgründen erforderlich
- Eine kostenlose, voll ausgestattete Plattform für kleine Teams wird gewünscht
- Einfachheit hat Priorität — eine Binary, keine Abhängigkeiten
Die ehrliche Wahrheit
GitBook ist gut für Teams, die im Browser arbeiten. Valoryx ist besser für Teams, die in git arbeiten. Die entscheidende Frage ist, wo die Quelle der Wahrheit liegt — und wer sie kontrolliert.