---
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](https://tiddlywiki.com/) |
| **GitHub** | [Jermolene/TiddlyWiki5](https://github.com/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.

```yaml
# 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)

```bash
# 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** :

```bash
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

- [Site officiel TiddlyWiki](https://tiddlywiki.com/)
- [Documentation](https://tiddlywiki.com/docs.html)
- [GitHub Jermolene/TiddlyWiki5](https://github.com/Jermolene/TiddlyWiki5)
- [Groupe communautaire Talk](https://talk.tiddlywiki.org/)
- [Awesome TiddlyWiki](https://github.com/sapegin/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
