Wiki.js

Wiki.js ist eine quelloffene Wiki-Software auf Node.js-Basis. Sie speichert Wissen in versioniertem Markdown und macht diese Inhalte über eine GraphQL-API maschinell zugänglich, sodass das Wissen nicht in der Oberfläche eingeschlossen bleibt.

---

Wissen als integrierbare Datenquelle

Der eigentliche Wert von Wiki.js liegt weniger im Bearbeiten von Seiten als in der maschinellen Anbindung des gepflegten Wissens. Jede Seite ist Markdown mit YAML-Kopf, jede Änderung ist versioniert, und der gesamte Bestand lässt sich über eine Programmierschnittstelle abfragen. Damit wird ein Wiki von einem reinen Nachschlagewerk zu einer Quelle, an die sich weitere Systeme andocken können.

Funktionsumfang

Wiki.js deckt die Kernaufgaben eines modernen Wikis ab:

• Editoren: Markdown mit Live-Vorschau ist der Standard; daneben stehen ein WYSIWYG-Editor sowie ein Editor für rohes HTML zur Verfügung.
• Versionierung: Jede inhaltliche Änderung wird festgehalten. Frühere Stände lassen sich vergleichen und wiederherstellen, die Bearbeitungshistorie bleibt nachvollziehbar.
• Struktur und Suche: Eine Navigationshierarchie, Tags und eine integrierte Volltextsuche erschliessen den Bestand.
• Zugriff und Authentifizierung: Lokale Konten und externe Anbieter über Standards wie OAuth2, OpenID Connect, SAML oder LDAP regeln, wer lesen und schreiben darf.

Die Datenhaltung ist konfigurierbar: Inhalte liegen in einer relationalen Datenbank und lassen sich zusätzlich mit einem Git-Repository oder dem Dateisystem synchronisieren.

Die GraphQL-API als integrierender Kern

Wiki.js ist durchgängig um eine GraphQL-API herum gebaut. Die Verwaltungsoberfläche selbst spricht mit demselben Endpunkt, über den auch externe Programme arbeiten. Über diese Schnittstelle lassen sich Seiten und ihre Metadaten abfragen sowie anlegen, ändern und verschieben. Die Authentifizierung erfolgt mit API-Schlüsseln, die als JWT-Token im Bearer-Header mitgesendet werden.

Diese programmatische Bereitstellung ist der Grund, weshalb Wiki.js sich als Wissensbaustein in grössere Architekturen einfügt. Der versionierte Markdown-Bestand lässt sich automatisiert auslesen, etwa um ihn in ein Retrieval-System (RAG) zu überführen oder ein eigenes Frontend mit den Inhalten zu speisen. Das schriftlich gepflegte Wissen wird so zu einer Datenquelle, die über die Weboberfläche hinaus nutzbar ist. Wer die zugehörigen YAML-Kopfdaten strukturiert pflegt, erleichtert diese maschinelle Weiterverarbeitung zusätzlich; die Grundlagen dazu beschreibt das YAML-Frontmatter.

Lizenz und Projektstand

Wiki.js steht unter der AGPL-v3 und läuft als Node.js-Anwendung, die sich selbst betreiben lässt. Die stabile Linie ist die 2.x-Reihe; deren letzte Veröffentlichung (2.5.314) datiert vom Mai 2024, der Bestand gilt als ausgereift und ist breit im Einsatz. Eine vollständig neu geschriebene Version 3 ist seit 2022 in Entwicklung, ein verbindlicher Termin für eine stabile Freigabe liegt jedoch nicht vor. Wer Wiki.js einsetzt, sollte diese verlangsamte Veröffentlichungskadenz einkalkulieren und die produktive 2.x-Reihe als Grundlage betrachten.

Einordnung

Wiki.js eignet sich dort, wo Wissen versioniert, durchsuchbar und zugleich maschinell weiterverwendbar sein soll. Gegenüber einem rein lokalen Werkzeug wie Obsidian ist Wiki.js eine serverseitige Anwendung für den geteilten Zugriff mehrerer Personen; sein Unterscheidungsmerkmal ist die offene API, die das Wissen anschlussfähig macht.

Referenzen

• Wiki.js Releases auf GitHub. Letzte stabile Freigabe 2.5.314. (01.05.2024). github.com/requarks/wiki/releases
• Wiki.js Entwicklungsvorschau zu Version 3. Stand der Neuentwicklung, kein verbindlicher Freigabetermin. (12.10.2023). beta.js.wiki/blog
• Wiki.js Projektseite und Funktionsübersicht. Quelloffenes Wiki auf Node.js unter AGPL-v3. (2024). js.wiki/

Verwandte Themen

• Obsidian, das Vergleichswerkzeug zu Wiki.js.
• YAML-Frontmatter, der Metadatenstandard für Wiki.js.