Chapitre 07
Le confort : Tasks, Kanban, schémas… et Obsidian Git

1. Tasks

Les cases à cocher markdown sont partout dans le vault : dans les notes quotidiennes, dans les fiches projet. Le problème n'est pas de les écrire, c'est de les retrouver. Tasks ajoute une syntaxe de métadonnées et un langage de requête dédié.

- [ ] Vérifier la rétraction du bras 3 📅 2026-08-15 ⏫
- [ ] Relancer l'intégrateur 🔁 every week
- [x] Envoyer le rapport FAT ✅ 2026-08-01

Les émojis sont la syntaxe du plugin : 📅 échéance, ⏫ priorité haute, 🔁 récurrence, ✅ date de complétion, 🛫 date de début. Ils se saisissent par une commande dédiée plutôt qu'à la main.

```tasks
not done
due before in 7 days
sort by due
```

2. Kanban

Un tableau à colonnes, glisser-déposer, stocké dans un fichier markdown ordinaire — une liste par colonne. C'est sa qualité : le tableau reste lisible et versionnable même sans le plugin.

3. Les schémas

Trois façons de mettre un dessin dans un vault, et le critère de choix n'est pas le confort de tracé : c'est sous quelle forme le dessin est stocké. Un vault versionné hérite de ce format à chaque modification.

Mermaid — le diagramme comme code

Natif, sans rien installer. On décrit la structure, le moteur dessine :

```mermaid
flowchart LR
    PLC[S7-1500] -->|PROFINET| IO[IO Device]
    PLC -->|OPC-UA| EDGE[Edge Debian]
    EDGE -->|TimescaleDB| SUP[Supervision]
```

Organigrammes, séquences, machines à états, Gantt, entité-association. Le fichier reste une note ordinaire, indexée par la recherche, et une modification produit un diff qu'on lit. Sa limite : la mise en page est décidée par le moteur, donc inadapté à un schéma dont la disposition spatiale porte du sens — un synoptique d'installation, un plan d'armoire.

Canvas — penser dans l'espace

Plugin cœur. Un nœud de canvas peut être une carte de texte, une image, ou une note du vault affichée en vrai. C'est ce qui le distingue d'un outil de dessin : un canvas devient une carte de ton vault plutôt qu'une illustration à côté. Le format .canvas suit une spécification JSON publiée, donc lisible par d'autres outils.

Excalidraw — et pourquoi le vault de référence l'a retiré

Dessin à main levée. Le fichier .excalidraw.md est hybride : le texte des éléments est extrait en clair — donc cherchable — mais la géométrie est du JSON compressé en base64 par défaut. Chaque retouche réécrit le blob entier : git diff affiche une ligne illisible remplacée par une autre, et le dépôt stocke une copie complète à chaque sauvegarde. Les images collées sont encodées dans le fichier, ce qui fait grossir vite.

Si le croquis à main levée est indispensable, désactive la compression dans les réglages du plugin : le JSON devient lisible et diffable, au prix d'un fichier plus gros.

4. Advanced Tables et Style Settings

Advanced Tables rend les tableaux markdown éditables : la tabulation passe de cellule en cellule, les colonnes se réalignent toutes seules. Sans lui, un tableau de plus de trois colonnes se maintient à la main, et personne ne le fait.

Style Settings expose sous forme de réglages les variables CSS que les thèmes déclarent : largeur de ligne, taille de police, couleurs d'accent. Utile si ton thème le supporte, inerte sinon.

Ces deux-là ne stockent rien : les retirer ne perd aucune donnée. C'est le meilleur profil de risque pour un plugin tiers.

5. Obsidian Git

Le vault est un dossier de fichiers texte : git est le mécanisme de synchronisation naturel. Historique complet, sauvegarde, et rien à payer. Le plugin Obsidian Git l'automatise depuis l'application.

{
  "autoSaveInterval": 10,
  "autoPullOnBoot": true,
  "commitMessage": "vault: {{date}}"
}

Traduction : tirer les modifications distantes à l'ouverture, puis commiter et pousser automatiquement toutes les dix minutes. En usage courant, tu n'y penses jamais — tu écris, ça se sauvegarde.

Limite 1 — pas de hooks git

Limite 2 — l'auto-commit ne distingue pas ton travail

L'auto-commit prend tout ce qui a changé dans le dépôt, sur la branche courante. Tant que tu écris des notes, c'est ce que tu veux. Si tu modifies en parallèle du code dans le vault — l'outillage de la partie II vit dedans — l'auto-commit balaie ton travail en cours au milieu d'une modification.

C'est arrivé pendant la construction du vault de référence : un commit vault backup: 2026-08-02 16:20:22 a emporté sept fichiers de code à moitié testés. Sans dégât — il a suffi de vérifier le contenu et d'amender le commit — mais la leçon est simple.

Conflits

Deux machines qui modifient la même note sans se synchroniser produisent un conflit git ordinaire, avec ses marqueurs <<<<<<< insérés dans la note. Le plugin ne sait pas les résoudre : il faut ouvrir la note et trancher.

La prévention tient en une habitude : laisser autoPullOnBoot actif, et synchroniser avant de fermer plutôt qu'après avoir rouvert ailleurs.

6. Le coût d'un plugin

Chaque plugin tiers ajoute quatre dettes :

1. Du code tiers qui s'exécute dans ton application, avec accès à tous tes fichiers.
2. Une dépendance de version : il peut casser à une mise à jour d'Obsidian, et personne ne garantit la réparation.
3. Un format : s'il stocke dans une structure qui lui est propre, le retirer emporte les données.
4. Une reconstruction : sur une machine neuve, il faut le réinstaller à la bonne version, avec ses réglages. C'est tout l'objet de la partie II.

Récapitulatif

Exercices