6.6 KiB
title: TiddlyWiki created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, wiki, pkm, notes, javascript, single-file, portable, local-first] confidence: high contested: false sources: [https://selfh.st/apps/?tag=wiki]
🌿 TiddlyWiki
Wiki non-conventionnel fonctionnant dans un seul fichier HTML. Pas de base de données, pas de serveur : tout le wiki est un fichier
.htmlportable, éditable et sauvegardable. Une philosophie minimaliste unique en son genre.
| Métadonnée | Valeur |
|---|---|
| Site web | tiddlywiki.com |
| GitHub | Jermolene/TiddlyWiki5 |
| License | BSD-3-Clause |
| Langage | JavaScript |
| Étoiles | ⭐ 1248 |
| Dernière MAJ | 2026-06-01 |
| Catégorie | cat-wiki |
Description
TiddlyWiki est un concept à part : un wiki complet dans un seul fichier HTML qui se charge et fonctionne dans n'importe quel navigateur, sans serveur, sans base de données. Créé par Jeremy Ruston en 2004, c'est l'un des projets de wiki personnel les plus anciens et les plus atypiques. Son nom évoque les « tiddlers » — les petites unités de contenu (l'équivalent des « pages » ailleurs).
La philosophie est local-first et portable : on peut copier le fichier .html sur une clé USB, l'envoyer par mail, le versionner dans Git, le synchroniser via Dropbox, et il fonctionnera partout. Pour qui veut un PKM qui dure sans dépendance à un fournisseur cloud, c'est un choix radical mais tenace.
Le langage interne (Wikitext) est très riche : transclusion, filtres, macros, variables, variables dynamiques, programmable. La communauté fournit des plugins pour les flashcards SRS, le calendrier, le rendu Mermaid, le markdown, le calendrier, les maths KaTeX, le highlighting, etc. On peut aussi étendre TiddlyWiki avec Node.js pour en faire un wiki multi-utilisateurs (mode Node.js server).
TiddlyWiki est idéal comme PKM personnel ultra-léger. Pour un wiki de projet ou d'équipe, on s'orientera vers app-wiki-js, app-docmost ou app-dokuwiki. Pour un outliner moderne, app-logseq ou Obsidian sont plus actuels.
Installation
Option 1 : Docker (mode Node.js serveur)
Pour un wiki multi-utilisateurs, on déploie TiddlyWiki en mode Node.js dans un conteneur. Cela permet l'édition simultanée, l'auth et la synchro.
# docker-compose.yml
services:
tiddlywiki:
image: mernix/tiddlywiki:latest
container_name: tiddlywiki
restart: unless-stopped
environment:
- TW_WIKINAME=MonWiki
- TW_USERNAME=admin
- TW_PASSWORD=changez-moi
volumes:
- tiddlywiki-data:/var/lib/tiddlywiki
ports:
- "8080:8080"
volumes:
tiddlywiki-data:
Variante officielle : tiddlywiki/tiddlywiki sur le Hub Docker, à personnaliser avec un init qui crée le wiki.
Option 2 : Fichier unique (le plus simple)
# Télécharger l'empty.html officiel
wget https://tiddlywiki.com/empty.html -O mon-wiki.html
# Ouvrir dans un navigateur, l'extension TiddlyFox (FF) ou Timimi (autres) auto-sauvegarde en local
Pour le mode Node.js manuel :
npm install -g tiddlywiki
tiddlywiki mon-wiki --init server
tiddlywiki mon-wiki --listen port=8080
Prérequis : Node.js 16+.
Configuration
Configuration par le panneau Control Panel → Settings :
- Titre du wiki, sous-titre, favicon, couleur du thème : onglet Basics.
- Langage : TiddlyWiki supporte de nombreuses traductions (français inclus).
- Thème :
vanillapar défaut, plus d'autres (Snow White, DarkTwilight, etc.), custom CSS viaSettings → Theme tweaks. - Sauvegarde auto : via plugin
Timimi(Linux/Windows) ouTiddlyFox(Firefox) ou l'auto-save natif en Node. - Plugins :
Plugins → Search plugins, activables en un clic. Catégories : Languages, Themes, Editors, Tools, etc. - Filtres et macros : on ajoute des tiddlers
$:/macros/...et$:/filters/...pour étendre le langage. - Multi-comptes : en mode Node, on configure l'auth via
$:/config/tiddlyweb/...ou les plugins d'auth.
Alternatives
Open Source
- app-logseq — Outliner PKM moderne, Markdown, multi-plateforme.
- app-wiki-js — Wiki Node.js d'équipe avec WYSIWYG.
- app-dokuwiki — Wiki PHP simple, fichiers plats, le vétéran.
- app-raneto — Wiki Markdown Node, plus classique.
- app-mkdocs — Doc statique Python (publication, pas édition).
- app-docusaurus — Doc statique Node/MDX (publication).
- Obsidian — Markdown + graphe, local-first, plugins (fermé, gratuit).
- Joplin — Notes synchronisées, plus classique.
- Trilium Notes — PKM hiérarchique open source, single-user.
- SiYuan — Block-level PKM, open source.
Propriétaires (ce que TiddlyWiki remplace)
- Notion — Pour le PKM personnel, TiddlyWiki est gratuit et local.
- Evernote / OneNote — Carnets de notes classiques, TiddlyWiki est plus minimal et durable.
- Roam Research — L'outliner PKM, mais TiddlyWiki est gratuit et portable.
- Tana — Outliner IA, plus récent.
- Apple Notes / Google Keep — Pour qui veut un wiki structuré, TiddlyWiki offre bien plus.
Sécurité
- ✅ Mode single-file : pas de serveur, pas de surface d'attaque, pas d'auth à gérer — c'est le plus sûr.
- ✅ Mode Node.js : il faut un reverse proxy HTTPS (Caddy/Traefik) et un système d'auth (
$tw.utils.userHasRole). - ⚠️ Le fichier
mon-wiki.htmlest la base de données : un backup régulier est vital (Git, Syncthing, copie périodique). - ⚠️ En mode local, attention aux synchros cloud type Dropbox/iCloud : le fichier peut se corrompre en cas de conflit. Préférer Git ou un WebDAV robuste.
- ⚠️ Les plugins tiers peuvent exécuter du JS arbitraire : ne charger que des plugins de confiance (auteur connu, code audité).
- ✅ En mode Node, chiffrement HTTPS et auth solides sont obligatoires en multi-utilisateurs.
- ✅ TiddlyWiki supporte l'encryption at rest (AES) sur le wiki Node.js pour le contenu sensible.
Ressources
- Site officiel TiddlyWiki
- Documentation
- GitHub Jermolene/TiddlyWiki5
- Groupe communautaire Talk
- Awesome TiddlyWiki
Pages Liées
- cat-wiki — Vue d'ensemble de la catégorie Wiki
- app-logseq — PKM moderne, outliner
- app-wiki-js — Wiki Node.js moderne
- app-dokuwiki — Wiki PHP vétéran
- recettes-docker-compose — Templates Docker partagés