Wiki.js 3 ist da. Und es hat sich gelohnt zu warten
Stand: 01.11.2026
Nach einer langen, sehr langen Wartezeit ist Wiki.js 3 endlich erschienen, aktuell als Version 3.0.1. Und ich muss sagen: Es hat ordentlich gerappelt. Nicht nur, dass die Version 3 überhaupt raus ist, nein, ganz viele Community-Wünsche haben den Weg ins Release gefunden. Ich habe mein Upgrade hinter mir und ziehe ein erstes Fazit.
Zwei Markdown-Editoren, und der zweite ist gut für mich
Beim Anlegen einer neuen Seite fallen sofort die Editor-Optionen auf. Oben im Menü gibt es zwei Wege, eine Seite zu schreiben:
Der erste Editor ist im Wesentlichen der alte, bewährte Markdown-Editor, den ich von Version 2.5.x her kenne und zu schätzen gelernt habe. Wer wie ich monatelang damit gearbeitet hat, fühlt sich sofort zu Hause. Kein Umlernen nötig, die Tastenkürzel sitzen noch.
Der zweite von oben, der Visual Editor, ist definitiv einen Blick wert. Wer schon immer mal überlegt hat, wikilose Kollegen oder Familienmitglieder ans Editieren zu lassen, ohne ihnen Markdown zuzumuten, bekommt hier eine plausible Antwort. Man tippt, und dahinter entsteht Markdown. Das Konzept kenne ich von anderen Werkzeugen, hier ist es sauber umgesetzt.
Daneben gibt es mit AsciiDoc und einer Drawing-Seite (draw.io) weitere Schreib- und Zeichenwege. Das Seiten-Menü sieht inzwischen so aus:
- New Markdown Page
- New Visual Page
- New AsciiDoc Page
- New Drawing Page
- New Blog
- New Feedback Board
- New Live Note
- New Redirection
- Upload Media Asset
Ja, richtig gelesen: New Blog. Wiki.js 3 bringt eine eigene Blog-Funktion mit. Und ein Feedback Board. Und Live Notes. Das Projekt öffnet sich damit deutlich in Richtung "mehr als nur Wiki".
Was jetzt von Haus aus drin ist
Für mich persönlich die erfreulichste Nachricht: Viele Dinge, die man früher selbst-stricken musste, sind jetzt eingebaut.
Sitemap-Integration. Unter 2.5.x habe ich die Sitemap per PostgreSQL-Cronjob generieren und danach per Root-Cronjob in den DocumentRoot kopieren lassen. Zwei Cronjobs, zwei Fehlerquellen, ein Skript mehr, das gepflegt werden will. Diese ganze Konstruktion kann ich jetzt entsorgen, weil die Sitemap integriert ist. Weniger eigene Skriptpflege ist für einen Admin immer ein Gewinn.
Kommentar-Übersicht. Auch die Moderation von Kommentaren hat jetzt eine eigene Übersicht. Wer Kommentare zulässt, muss nicht mehr durch einzelne Seiten wandern.
Content Blocks: die bunten Zettelchen
Wiki.js hatte schon immer "Content Blocks" für dynamische Inhalte, aber die Auswahl in Version 3 ist ordentlich gewachsen.
Kurzer Überblick über das, was out of the Box dabei ist:
| Block | Zweck |
|---|---|
| Badge | kurzes Statuslabel im Text (Beta, New, Deprecated) |
| Color | Farbcodes mit Farbprofil im Text |
| Countdown | zählt auf Datum und Uhrzeit herunter |
| Diagram | zeichnet Mermaid-Diagramme (Flowchart, Sequenz, ER, Gantt …) |
| Draw.io | Diagramm auf Canvas, gespeichert als eigenes XML |
| Image Gallery | Bildraster mit Lightbox |
| Include | bindet den Inhalt einer anderen Seite ein |
| Index | Seitenliste eines Ordners |
| Infobox | Faktenkasten neben dem Text |
| KaTeX / MathJax | TeX-Formeln, inklusive chemischer Gleichungen |
| Keyboard Shortcut | Tastenkürzel, gezeichnet wie echte Tasten |
| Kroki | Diagramme über Kroki-Server (Graphviz, D2, BPMN, Vega, TikZ …) |
| Links Grid | Kartenraster mit Links |
| Map | OpenStreetMap-Einbettung |
| Measurement | Maße und Einheiten in der Lesereinheit |
| Media Player | Audio und Video inline |
| PDF Viewer | PDF seitenweise im Viewer |
| PlantUML | PlantUML-Diagramme |
| Progress | Fortschrittsbalken im Text |
| QR Code | QR-Code für Link oder Text |
| Spoiler | Inhalt hinter Aufdeck-Cover |
| Steps | nummerierte Liste als Schrittfolge |
| Terminal Recording | asciinema-Aufnahmen (.cast) im Terminal-Player |
| Timestamp | Datum/Uhrzeit in der Zeitzone des Lesers |
| Youtube Player | eingebettetes YouTube-Video |
Die Blocks sind eigenständige Lit-Web-Components, und wer will, kann eigene bauen. Das Diagramm-Block-Angebot allein (Mermaid, Draw.io, Kroki, PlantUML) reicht aus, um meine gesamten Infrastruktur-Zeichnungen direkt im Wiki zu behalten statt extern.
Und der Rest?
Was bleibt nach dem ersten Eindruck hängen: viel weniger Eigenbau, mehr Methoden, Inhalte in eigenen Editoren zu erfassen, und der Umstieg fällt leicht, weil der gewohnte Markdown-Editor unverändert an Bord ist. Der Visual Editor ist mein Kandidat für die nächsten Wochen, den teste ich im Tagesgeschäft.
Den Vergleich zwischen dem Blog hier bei Serendipity und dem neuen Wiki.js-eigenen Blog-Bereich verschiebe ich auf einen Folgeartikel, das passt hier nicht mehr in einen Artikel.
Hinweis: Ich betreibe mein Wiki.js in Docker mit eigener PostgreSQL-Instanz. Details zum Upgrade-Pfad und zu Stolperfallen beim Datenbank-Umzug folgen im zweiten Teil.

In Season 3 sind aktuell bereits wieder 8 Spieler dabei, die um die Vorherrschaft in der Galaxie ringen. Das ist ein guter Anlass für einen Hinweis, der bisher nur am Rande gefallen ist: MMO-20044 ist Open Source.
Das Spiel gibt an bestimmten Stellen Hinweise, wenn etwas noch nicht stimmt. Wer zum Beispiel einen Gesteinsplaneten besiedelt hat, aber noch keinen Bergbau erforscht, bekommt den Hinweis direkt im Dashboard. Kein stilles Warten, keine Raterei warum die Rohstoffe nicht wachsen. Der Tipp verschwindet, sobald die passende Forschung gestartet ist.

