Files
2026-06-09 18:40:21 +02:00

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 .html portable, é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 : vanilla par défaut, plus d'autres (Snow White, DarkTwilight, etc.), custom CSS via Settings → Theme tweaks.
  • Sauvegarde auto : via plugin Timimi (Linux/Windows) ou TiddlyFox (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.html est 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

Pages Liées