Obsidian au quotidien : des notes, des templates et un coffre bien au chaud dans Git

Le matin, il y a les onglets déjà ouverts, les messages qui arrivent et cette petite question : j’en étais où, hier ? Une décision prise pendant un échange, une commande qui a enfin fonctionné, une idée pour débloquer une US… Tout cela mérite mieux qu’un coin de mémoire.

C’est là qu’Obsidian devient un compagnon de travail agréable. On ouvre sa note du jour, on retrouve le contexte, on écrit quelques lignes et on avance. Pas besoin de construire une encyclopédie : le plaisir vient surtout de retrouver facilement ce que l’on a pris le temps de noter.

Voici une organisation à adapter à son quotidien de développement, avec des exemples prêts à copier : un coffre lisible, des templates qui évitent les gestes répétitifs et Git pour conserver l’historique.

Un coffre qui ressemble à notre façon de travailler

Un coffre Obsidian, c’est un dossier contenant notamment des notes Markdown. On peut les ouvrir avec d’autres outils, les versionner et les organiser à son rythme. Les liens internes comme [[US-142]] permettent de naviguer entre une journée, une fonctionnalité et une décision technique.

Imaginez cette chaîne : la note du jour renvoie vers une US, l’US vers un schéma et le schéma vers une explication d’architecture. La prochaine fois que le sujet revient, le chemin est déjà là.

Pour démarrer, une poignée de dossiers suffit :

MonCoffre/
├── 00-Inbox/
├── 01-Quotidien/
├── 02-Projets/
│   └── MonProduit/
│       └── US/
├── 03-Ressources/
├── 04-Dessins/
├── 90-Templates/
└── 99-Archives/

L’Inbox accueille les pensées encore sans adresse. Les projets rassemblent le travail en cours. Les ressources gardent les recettes réutilisables : une commande Docker, un rappel SQL, une checklist de revue. Les archives accueillent ce qui n’est plus actif.

Le bon rangement est celui qui demande peu d’efforts. Si chaque note exige trois minutes de réflexion avant même d’écrire, simplifiez les dossiers.

Les extensions qui se complètent vraiment

Activez d’abord Notes quotidiennes, Liens retour et Palette de commandes dans les modules principaux. Pour les extensions communautaires, passez par Paramètres → Modules complémentaires → Parcourir, puis installez et activez celles dont vous avez besoin.

Voici une sélection où chaque outil a un rôle clair :

Leur intérêt vient aussi de leur complémentarité : Templater prépare la note, Tasks fait ressortir les actions, Excalidraw clarifie une idée et Git conserve les changements. Iconize aide à naviguer ; Emoji Toolbar apporte une touche personnelle au contenu.

Commencez avec Notes quotidiennes et Templater, puis ajoutez les autres lorsque le besoin apparaît. Une petite configuration que l’on utilise vaut largement un coffre rempli de boutons oubliés.

La note quotidienne : un point de départ chaque matin

Dans les réglages du module principal Notes quotidiennes, choisissez :

• Emplacement des nouveaux fichiers : 01-Quotidien.
• Format de date : YYYY/MM/YYYY-MM-DD.
• Emplacement du modèle : 90-Templates/Quotidien.md.

Ce format range automatiquement une note comme 01-Quotidien/2026/11/2026-11-05.md. La commande d’ouverture de la note du jour retrouve le fichier existant ou le crée. Vous pouvez lui attribuer un raccourci dans Paramètres → Raccourcis clavier. Ces options sont décrites dans l’aide officielle des notes quotidiennes.

Pour que les expressions Templater soient évaluées, configurez aussi l’extension :

1. Indiquez 90-Templates dans Template folder location.
2. Activez Trigger Templater on new file creation.
3. Laissez Notes quotidiennes insérer son modèle ; n’ajoutez pas une deuxième règle de dossier Templater pour ce même journal.

On conserve ainsi un seul modèle inséré à la création. Le module principal Templates reste facultatif pour cette recette. Voir les réglages de Templater pour les déclencheurs.

Créez ensuite le fichier 90-Templates/Quotidien.md avec ce contenu :

---
type: quotidien
date: <% tp.date.now("YYYY-MM-DD", 0, tp.file.title, "YYYY-MM-DD") %>
tags:
  - quotidien
---

# Journal du <% tp.date.now("DD/MM/YYYY", 0, tp.file.title, "YYYY-MM-DD") %>

## Mon cap du jour

L’essentiel à faire avancer :

## US en cours

- US : [[US-142]]
- Prochaine étape :
- Blocage éventuel :

## Actions

- [ ] Définir ma première action concrète

## Au fil de la journée

- 09:00 —

## Ce que je garde

Une découverte, une commande utile ou une décision à relier.

## Avant de fermer

- Avancée du jour :
- Point à reprendre demain :

La date du template est calculée à partir du nom de la note : pratique si vous créez une note pour une autre journée. Remplacez [[US-142]] par l’US réelle, ou supprimez cette ligne quand elle ne sert pas.

Ouvrez une nouvelle note quotidienne pour tester : les expressions <% ... %> doivent avoir laissé place aux dates. Une note déjà créée n’est pas régénérée automatiquement ; si elle contient encore ces expressions, utilisez la commande Templater Replace templates in the active file.

La structure est volontairement légère. On peut noter un blocage en deux lignes, coller une piste de solution ou préparer son point d’équipe sans rédiger un compte rendu solennel.

Une fiche d’US qui se nomme et se range toute seule

Une User Story mérite un endroit où garder le contexte : ce que l’on cherche à résoudre, les critères d’acceptation, les choix techniques et les questions encore ouvertes.

L’idée : créer une fiche, renseigner le numéro et le titre, puis laisser Templater la déplacer dans 02-Projets/MonProduit/US. Le fichier s’appellera US-142.md et son titre visible pourra être « US-142 — Ajouter les filtres de recherche ». Les liens [[US-142]] restent ainsi courts.

Créez d’abord le dossier de destination, puis enregistrez ce modèle dans 90-Templates/US.md :

<%*
const saisie = await tp.system.prompt("Numéro de l’US, par exemple 142");
if (!saisie || !/^\d+$/.test(saisie.trim())) {
  throw new Error("Création annulée : indiquez un numéro d’US valide.");
}
const titre = await tp.system.prompt("Titre de l’US");
if (!titre || !titre.trim()) {
  throw new Error("Création annulée : le titre est obligatoire.");
}
const id = `US-${saisie.trim()}`;
const dossier = "02-Projets/MonProduit/US";
if (await tp.file.exists(`${dossier}/${id}.md`)) {
  throw new Error(`La note ${id} existe déjà : ouvrez-la plutôt.`);
}
await tp.file.move(`${dossier}/${id}`);
tR += `---
type: us
projet: MonProduit
us: ${id}
statut: en-cours
creation: ${tp.date.now("YYYY-MM-DD")}
tags:
  - travail/us
---

# ${id} — ${titre.trim()}

## Besoin

En tant que… je souhaite… afin de…

## Références

- Ticket :
- Branche :
- Pull request :

## Critères d’acceptation

- [ ] Premier comportement attendu

## Actions techniques

- [ ] Première étape de réalisation

## Questions et blocages

## Décisions

## Vérifications et démonstration

## Journal

- [[${tp.date.now("YYYY-MM-DD")}]] — Début du travail.
`;
%>

Pour l’utiliser, lancez Templater: Create new note from template et sélectionnez US. Saisissez 142, puis le titre. La fiche arrive dans le dossier prévu ; ajoutez [[US-142]] à votre journal pour retrouver le contexte d’un clic.

Le déplacement utilise un chemin depuis la racine du coffre, sans extension .md, comme le prévoit l’API de fichiers Templater. Les questions utilisent tp.system.prompt.

Adaptez MonProduit dans le chemin et dans les propriétés. Pour plusieurs projets, gardez des identifiants uniques dans le coffre, par exemple WEB-US-142 et API-US-142, afin d’éviter les liens ambigus. Ce modèle s’applique à la création d’une nouvelle fiche, une seule fois.

Tasks : retrouver les actions sans les recopier

Une case Markdown comme - [ ] Relire la PR fonctionne déjà dans Obsidian. Tasks ajoute notamment des dates et des requêtes pour rassembler les actions dispersées.

Pour les exemples ci-dessous, laissez le Global task filter vide dans les réglages de Tasks. Si vous préférez un filtre comme #task, ajoutez ce tag aux tâches concernées.

Dans une fiche d’US, on peut écrire :

- [ ] Vérifier le filtre par statut 📅 2026-11-06
- [ ] Demander une revue de [[US-142]]

La date après 📅 représente une échéance ; adaptez-la à votre planning. La commande Tasks de création ou modification d’une tâche permet aussi de la renseigner sans mémoriser la syntaxe.

Créez une note 02-Projets/MonProduit/Tableau de bord.md avec cette vue :

# Actions du projet

```tasks
not done
path includes 02-Projets/MonProduit/US/
sort by due
group by filename
```

Elle rassemble les tâches ouvertes des fiches d’US, regroupées par fichier. Une case cochée dans le résultat met à jour la tâche d’origine : plus besoin de recopier les listes entre le journal et le projet. Gardez les exemples de tâches dans 90-Templates, hors du périmètre de cette requête.

Pour une vue des échéances, ajoutez ce bloc à votre tableau de bord ou au modèle quotidien :

```tasks
not done
path includes 02-Projets/
due before tomorrow
sort by due
```

Il affiche les tâches en retard et celles dues aujourd’hui ; les tâches sans échéance n’y figurent pas. « Aujourd’hui » suit la date courante, même dans une ancienne note quotidienne : cette vue est vivante, pas une photographie historique. La documentation des requêtes Tasks fournit d’autres combinaisons.

Garder son coffre dans un dépôt Git personnel

Avec Git, on peut retrouver une ancienne formulation, voir ce qui a changé ou récupérer une note supprimée après son enregistrement. Un dépôt distant privé conserve aussi une copie des fichiers envoyés.

Un dépôt privé n’est pas un coffre chiffré de bout en bout. Gardez les mots de passe et les clés hors des notes. Pour les informations professionnelles, utilisez uniquement un stockage autorisé par votre organisation ; les exemples d’US de cet article peuvent rester fictifs dans un coffre personnel.

Initialiser le dépôt sur ordinateur

Installez Git, créez un dépôt distant privé et vide chez votre hébergeur, puis ouvrez un terminal dans le dossier du coffre. Avant le premier ajout, créez un fichier .gitignore :

# Disposition des fenêtres propre à chaque appareil
.obsidian/workspace.json
.obsidian/workspace-mobile.json

# Corbeille locale et fichiers du système
.trash/
.DS_Store
Thumbs.db

# Fichiers locaux à exclure avant tout commit
.env
.env.*
*.pem
*.key

Ce choix conserve les autres réglages de .obsidian, dont ceux des extensions : relisez-les avant de les envoyer, certains peuvent contenir des informations sensibles. Si vous souhaitez versionner uniquement le contenu, ignorez plutôt tout le dossier .obsidian/ ; les thèmes et réglages ne seront alors pas partagés par Git.

Initialisez ensuite le dépôt :

git init -b main
git status --short

Vérifiez les fichiers proposés, puis enregistrez-les :

git add .
git diff --cached
git commit -m "Initialise mon coffre Obsidian"

Remplacez l’adresse suivante par l’URL SSH de votre dépôt privé, avec une clé SSH déjà configurée chez l’hébergeur :

git remote add origin git@github.com:VOTRE-COMPTE/mon-coffre-prive.git
git push -u origin main

Un .gitignore ne retire pas les fichiers déjà suivis et n’efface pas leur historique. Si un secret a été envoyé, il faut le révoquer ; l’ajouter ensuite au fichier d’exclusion ne suffit pas.

Utiliser Git depuis Obsidian

Installez l’extension Git puis testez d’abord un cycle manuel dans sa palette de commandes : récupérer les changements (pull), modifier une note, créer un commit, puis envoyer les changements (push). Vérifiez sur le dépôt distant que le fichier est bien arrivé avant de configurer les automatismes.

Le projet Obsidian Git propose notamment le commit et la synchronisation automatiques. Sur ordinateur, Git doit être installé et l’authentification fonctionnelle ; l’extension s’appuie sur cette configuration. Commencez par une fréquence raisonnable, par exemple toutes les quinze minutes, selon les options proposées par votre version.

Sur un deuxième ordinateur, clonez le dépôt puis ouvrez le dossier obtenu comme coffre Obsidian. Prenez l’habitude de récupérer les changements avant d’écrire et de les envoyer avant de changer d’appareil. En cas de conflit, comparez les deux versions, conservez les informations utiles, puis enregistrez la résolution avant de reprendre la synchronisation.

Sur mobile, l’extension utilise une implémentation différente, avec des limitations documentées par le projet : ne supposez pas que la configuration de l’ordinateur se transpose telle quelle. Enfin, Git conserve ce que vous avez effectivement enregistré et envoyé ; gardez aussi une sauvegarde indépendante pour les fichiers oubliés ou les pièces jointes importantes.

Dessiner, personnaliser et avoir envie de revenir

Certains sujets se comprennent mieux avec des flèches. Avec Excalidraw, créez un dessin dans 04-Dessins, représentez les échanges entre votre interface et votre API, puis insérez-le dans la fiche d’US via un lien embarqué ![[Nom du dessin.excalidraw]]. Utilisez le nom réel du fichier créé par l’extension.

Le schéma reste près des notes qui l’expliquent. Au moment d’une revue ou d’un retour sur une ancienne décision, on retrouve le raisonnement avec le dessin.

Pour l’apparence, ouvrez Paramètres → Apparence → Thèmes → Gérer, parcourez les thèmes et choisissez Installer et utiliser. Le retour au thème par défaut se fait au même endroit. Le guide officiel des thèmes détaille aussi leur mise à jour.

Testez surtout le confort : lisibilité des liens, contraste des cases à cocher, tableaux et blocs de code. Un thème magnifique sur une capture doit aussi être reposant pendant une vraie journée de travail.

Avec Iconize, attribuez par exemple un calendrier au journal, un dossier aux projets et une ampoule aux ressources. Avec Emoji Toolbar, ajoutez quelques repères dans les titres : 💡 Idées, 🚧 Blocages, ✅ Bilan. Ces touches rendent le coffre accueillant sans remplacer des noms de fichiers explicites.

Une routine qui tient dans quelques minutes

Le matin, ouvrez la note du jour, reliez l’US en cours et choisissez une prochaine action concrète. Pendant la journée, capturez les décisions là où elles seront utiles : le contexte durable dans la fiche d’US, le déroulé dans le journal, les recettes réutilisables dans les ressources.

Avant de fermer, notez ce qui reste à reprendre et vérifiez l’envoi Git. Une fois par semaine, videz un peu l’Inbox et archivez ce qui est terminé.

C’est ce petit rituel qui fait le charme d’Obsidian : ouvrir un espace familier, retrouver le fil et sentir que les découvertes s’accumulent au lieu de disparaître. Les templates préparent le terrain ; le plus précieux reste ce que vous y déposez, quelques lignes à la fois.