EN
en direct

Wiki.js 3.0 réécrit entièrement la plateforme wiki et apporte le multi-sites et la collaboration en direct

Le 1er novembre 2026, Wiki.js publie la version 3.0, une réécriture complète du backend et du frontend qui apporte le multi-sites, la collaboration en direct et les blocs de contenu dynamiques. La migration depuis 2.x n’est pas une montée de version : elle passe par un export .wkbackup et une réinstallation, avec des changements de syntaxe markdown à anticiper.

Un tronc d’arbre sombre et massif dans une pièce tamisée se divisant en plusieurs branches ordonnées et taillées net, une seule petite feuille captant un reflet ambre.

1er novembre 2026. Wiki.js publie la version 3.0 stable, une réécriture complète du backend et du frontend. 2.5.317. C’est la dernière version de la branche 2.x, restée en place pendant des années tandis que la communauté s’impatientait — au point de se demander publiquement si « Wiki.js 3 est mort ? ». 1er novembre 2026. Le multi-sites, la collaboration en direct et les blocs de contenu deviennent réalité. Pourquoi c’est important : la plateforme wiki open source la plus attendue de l’écosystème self-hosted repart sur des fondations neuves, mais la migration depuis 2.x est un vrai projet, pas un simple changement de tag Docker.

Une réécriture pour solder les dettes de la 2.x

Le chef de projet Nicolas Giard le dit sans détour : la 3.0 est « une réécriture complète du backend et du frontend, pour résoudre les problèmes structurels de la 2.x ». Ces problèmes n’étaient pas anecdotiques. L’architecture de la 2.x, pensée à l’époque du Node.js monolithique, bridait trois fonctions que les utilisateurs réclamaient depuis des années — le multi-sites, la haute disponibilité et la collaboration en temps réel.

Résultat, Wiki.js s’était laissé distancer sur le terrain même où il excellait à l’origine : un wiki auto-hébergé, élégant et simple à déployer en Docker. Pendant que la 2.x stagnait, des alternatives comme Outline ou BookStack avançaient sur la collaboration et l’organisation multi-équipes. La 3.0 est la réponse : plutôt que de rafistoler l’existant, l’équipe a tout refait.

Ce qui change pour l’édition

L’éditeur Markdown — et son alternative AsciiDoc — repose désormais sur le moteur Monaco, celui de Visual Studio Code. Les utilisateurs y gagnent la coloration, la complétion et la navigation qui faisaient défaut à la 2.x. Un éditeur visuel entièrement nouveau stocke le contenu en markdown en arrière-plan, pour ceux qui préfèrent ne jamais voir le balisage.

La 3.0 introduit aussi de nouveaux types de pages : Dessin (formes et flèches via Excalidraw), Tableaux de suggestions (les utilisateurs soumettent, votent et commentent des idées), Blog (des billets au sein même du wiki) et Notes en direct. Tous les éditeurs, à l’exception des tableaux et du blog, supportent la collaboration en direct : on voit les curseurs des autres contributeurs et leurs modifications arrivent en temps réel.

Multi-sites : une instance, plusieurs wikis

C’est la fonction la plus structurante. Une seule instance Wiki.js peut désormais servir plusieurs wikis, chacun avec son propre nom de domaine, son thème, son stockage, sa connexion et ses éditeurs. Tout est cloisonné par site, à l’exception des utilisateurs et des groupes, partagés au niveau de l’instance.

Pour une équipe qui maintenait jusqu’ici une instance par service — une pour la documentation interne, une pour le client, une pour la base de connaissances publique — c’est une consolidation majeure. La gestion des permissions devient centralisée : un groupe peut définir des droits pour un seul ou plusieurs sites à la fois, sans multiplier les déploiements.

Les blocs de contenu, la vraie rupture

Les pages peuvent désormais embarquer du contenu dynamique via les blocs de contenu : lister toutes les pages d’un dossier, afficher un diagramme, une carte interactive, une galerie d’images, une infobox, un lecteur PDF, une boîte « spoiler » ou inclure le contenu d’une autre page. Wiki.js en livre plus de 25 d’origine, utilisables dans les trois éditeurs, et permet d’écrire ses propres blocs personnalisés.

S’y ajoutent un gestionnaire de fichiers avec éditeur d’images intégré (recadrage, redimensionnement, rotation, masquage), le retour de Visualiser les pages pour tous les utilisateurs, et une corbeille qui restaure les pages supprimées. Côté gouvernance, des règles d’approbation laissent un groupe réviser les modifications d’un autre, et des règles de cycle de vie affichent automatiquement une bannière « obsolète » sur une page non mise à jour depuis trois mois, en notifiant ses propriétaires.

La migration n’est pas une mise à jour

C’est le point qu’il ne faut pas sous-estimer. Il n’existe pas de mise à jour sur place depuis la 2.x. La migration est un processus explicite en trois temps :

  1. Créer un paquet .wkbackup : monter d’abord l’installation 2.x sur la dernière version 2.5.317, puis utiliser l’outil « Export for Wiki.js 3.x » de l’administration pour générer l’archive.
  2. Installer une 3.x vierge, puis lancer l’utilitaire « Import from Wiki.js 2.x ».
  3. Importer l’archive et vérifier les réglages du site et du système.

L’import est idempotent et peut être rejoué sans risque, les éléments existants étant ignorés sauf si l’option d’écrasement est cochée. Mais certains réglages ne sont volontairement pas importés : les réglages de modules (stockage, authentification, commentaires), les réglages de sécurité, le logo du site et le nom d’hôte — ce dernier pour éviter de se retrouver verrouillé dehors par un renvoi vers l’ancienne installation.

La syntaxe markdown change aussi sur quelques points précis, à anticiper avant l’import :

  • Admonitions : la syntaxe 2.x (classes CSS) reste supportée, mais il faut désormais écrire en syntaxe GitHub (> [!WARNING]) ;
  • Diagrammes (katex, kroki, mermaid, plantuml) : à envelopper dans leurs blocs de contenu respectifs ;
  • Draw.io : les diagrammes doivent être exportés en XML depuis la 2.x puis réinsérés via le bloc dédié ;
  • KaTeX/MathJax en ligne : la formule doit être entourée de dollars et de backticks ($…$) ;
  • Liens relatifs : ils pointent désormais vers le dossier parent, comme sur GitHub ;
  • Onglets : déclarés via le bloc tabs, l’ancienne syntaxe s’affichant en texte brut.

Verdict

Wiki.js 3.0 tient une promesse longtemps différée, et elle est tenue : la réécriture règle les trois dettes de la 2.x — multi-sites, collaboration, haute disponibilité — et ajoute un système de blocs qui rapproche le wiki d’une vraie plateforme de documentation.

Si votre Wiki.js 2.x tourne à l’identique depuis des années pour un petit groupe et que vous n’avez pas besoin du multi-sites ni de l’édition collaborative, rien ne presse — la 2.5.317 reste maintenue et fonctionnelle, et la migration est un vrai chantier. Si vous maintenez plusieurs instances, ou si la collaboration et la gouvernance d’approbation vous manquent, planifiez la migration dès maintenant : exportez le .wkbackup, testez l’import sur une 3.x de staging, et repassez vos pages à syntaxe ancienne avant la bascule. Le piège n’est pas la 3.0 elle-même — c’est de la traiter comme une montée de version alors qu’elle demande une migration assumée.

Références

Le brief cyber, chaque mardi

Les failles qui comptent, les correctifs à appliquer, en dix minutes de lecture.

Pas de spam. Désinscription en un clic.
à lire ensuite

Sur le même sujet

L’enquête selfh.st 2026 chiffre l’exode de Portainer, tombé de 66 % à 33 % en un an

L’enquête annuelle selfh.st, publiée le 12 novembre 2026 sur 6 221 réponses (+52 %), montre Portainer tomber de 66 % à 33 % de part parmi les utilisateurs d’outils de gestion de conteneurs, au profit de Dockhand, Komodo et Arcane, tandis que 60 % des sondés utilisent l’IA. Si votre homelab repose sur Portainer CE, cette bascule vous concerne directement.

Immich 3.4.0 apporte les tags aux applications mobiles, deux ans après leur lancement web

Le 10 novembre 2026, Immich a publié la version 3.4.0, qui porte enfin les tags — lancés en août 2024 mais réservés au web — vers les applications mobiles, aux côtés du JPEG XL et des passkeys. Si vous aviez organisé votre photothèque par tags, la parité mobile est là ; mettez à jour et réglez MACHINE_LEARNING_MODEL_REVISION=v2 pour récupérer le gain mémoire du conteneur ML.

← Retour au fil

Tapez au moins deux caractères.

↑ ↓ naviguer ↵ ouvrir esc fermer