Tutoriel sur Templater pour Obsidian

Découvrez comment maîtriser Templater, le puissant plugin d’Obsidian, pour automatiser vos tâches, structurer vos notes et libérer votre créativité. Que vous soyez débutant ou utilisateur avancé, ce tutoriel vous guidera pas à pas pour exploiter pleinement tout le potentiel de vos workflows personnalisés.

Étape 1 : Comprendre ce qu’est Templater

Question : À quoi sert Templater ?

Templater est un plugin d’Obsidian qui te permet d’utiliser des modèles personnalisés (templates). Ces modèles peuvent contenir des blocs de texte réutilisables, mais aussi des scripts dynamiques (via JavaScript) pour automatiser certaines tâches. Cela te permet de gagner du temps et d’ajouter de l’interactivité à tes notes.

Exemple basique :
Si tu crées souvent des notes de réunion, tu peux utiliser Templater pour insérer automatiquement la date et une structure de base (titre, sections, etc.).

Étape 2 : Installer Templater dans Obsidian

Instructions pas à pas :

  1. Ouvrir la communauté des plugins :
    • Dans Obsidian, clique sur les Paramètres (roue dentée).
    • Va dans la section Plugins communautaires (ou « Community plugins »).
  2. Rechercher Templater :
    • Clique sur Parcourir (ou « Browse »).
    • Dans la barre de recherche, tape Templater.
  3. Installer le plugin :
    • Une fois que Templater apparaît, clique sur Installer.
  4. Activer Templater :
    • Une fois installé, retourne dans la section Plugins communautaires.
    • Active Templater en cliquant sur le bouton correspondant.
  5. Configuration rapide :
    • Une fois activé, tu verras une nouvelle section Templater dans les paramètres.
    • On configurera ça un peu plus tard ; pour l’instant, l’important est de savoir qu’il est installé.

Continuons avec le premier usage basique de Templater !


Étape 3 : Créer un modèle simple avec Templater

But de cette étape :
Créer un modèle qui insère automatiquement la date et l’heure actuelles dans une note.


Instructions pas à pas :

  1. Créer un dossier pour les modèles :
    • Dans Obsidian, crée un nouveau dossier (par exemple, nomme-le Templates).
    • Ce dossier va contenir tous tes modèles.
  2. Configurer Templater pour utiliser ce dossier :
    • Va dans les ParamètresTemplater.
    • Sous « Template Folder Location », sélectionne le dossier que tu viens de créer (Templates).
  3. Créer un fichier de modèle :
    • Va dans le dossier Templates et crée un nouveau fichier (par exemple, nomme-le Date et Heure.md).
    • Ouvre ce fichier et ajoute-y ce contenu :
      La date et l'heure actuelles sont : <% tp.date.now("YYYY-MM-DD HH:mm") %>
  4. Utiliser ce modèle dans une note :
    • Ouvre une nouvelle note dans ton espace de travail.
    • Appuie sur le raccourci pour insérer un modèle (Ctrl+P ou Cmd+P, puis tape « Templater: Insert template »).
    • Choisis Date et Heure dans la liste.

👉 Résultat obtenu
La phrase « La date et l’heure actuelles sont : [date et heure] » devrait apparaître dans ta note avec la date et l’heure du moment.

Super, tu maîtrises déjà ton premier modèle dynamique avec Templater ! Passons maintenant à une étape un peu plus avancée.


Étape 4 : Ajouter de l’interactivité avec des variables dynamiques

But de cette étape :
Créer un modèle qui te demande des informations lorsque tu l’insères, comme le nom ou un sujet, pour personnaliser ta note.


Instructions pas à pas :

  1. Créer un nouveau modèle :
    • Va dans ton dossier Templates.
    • Crée un fichier nommé Note personnalisée.md.
  2. Ajouter du texte interactif :
    • Ouvre le fichier Note personnalisée.md et ajoute ceci :
      # Note personnalisée
      
      Salut, <% tp.user.prompt("Quel est ton nom ?") %> !  
      
      Sujet de la note : <% tp.user.prompt("Quel est le sujet ?") %>  
      
      Date de création : <% tp.date.now("YYYY-MM-DD") %>
      
  3. Insérer le modèle dans une nouvelle note :
    • Ouvre une nouvelle note.
    • Utilise le raccourci Ctrl+P (ou Cmd+P) → « Templater: Insert template ».
    • Choisis Note personnalisée.
  4. Interagir avec les invites :
    • Lors de l’insertion, Templater te demandera :
      • Ton nom.
      • Le sujet de la note.
    • Réponds aux questions et observe comment la note se personnalise.

👉 Résultat attendu :
Tu devrais voir une note comme celle-ci :

# Note personnalisée

Salut, Jean !

Sujet de la note : Apprendre Obsidian

Date de création : 2025-01-01

Excellent, tu avances vite ! Maintenant que tu sais insérer des variables dynamiques, explorons comment utiliser Templater pour automatiser des tâches plus complexes.


Étape 5 : Utiliser la logique conditionnelle

But de cette étape :
Créer un modèle qui ajuste son contenu en fonction d’une condition (par exemple, vérifier si la tâche est urgente ou non).


Instructions pas à pas :

  1. Créer un modèle conditionnel :
    • Va dans ton dossier Templates et crée un fichier nommé Tâche conditionnelle.md.
  2. Ajouter une logique conditionnelle :
    • Ouvre Tâche conditionnelle.md et ajoute ce contenu :
      # Nouvelle tâche  
      
      <%*  
      const urgent = tp.user.prompt("Est-ce une tâche urgente ? (oui/non)") === "oui";  
      if (urgent) { 
        tR += "⚠️ Cette tâche est urgente !\n";
      } else { 
        tR += "Cette tâche peut être traitée plus tard.\n";
      } 
      %>
      
  3. Insérer le modèle dans une note :
    • Crée une nouvelle note et insère Tâche conditionnelle comme tu l’as fait précédemment.
    • Réponds à la question « Est-ce une tâche urgente ? » avec « oui » ou « non ».

👉 Résultat attendu :

  • Si tu réponds « oui », tu verras :
    ⚠️ Cette tâche est urgente !
    
  • Si tu réponds « non », tu verras :
    Cette tâche peut être traitée plus tard.
    

Parfait ! Tu maîtrises déjà les bases des scripts dynamiques et de la logique conditionnelle avec Templater. Continuons avec une étape qui te permettra d’utiliser des boucles pour gérer des listes ou des répétitions.


Étape 6 : Utiliser des boucles pour créer des listes dynamiques

But de cette étape :
Créer un modèle qui te demande plusieurs éléments (par exemple, une liste de tâches) et les affiche sous forme de liste dans ta note.


Instructions pas à pas :

  1. Créer un modèle avec une boucle :
    • Va dans ton dossier Templates et crée un fichier nommé Liste de tâches.md.
  2. Ajouter une boucle dans le modèle :
    • Ouvre Liste de tâches.md et insère le code suivant :
      # Liste de tâches  
      
      <%*  
      const nbTaches = Number(tp.user.prompt("Combien de tâches veux-tu lister ?"));  
      for (let i = 0; i < nbTaches; i++) { 
        const tache = tp.user.prompt(`Tâche ${i + 1}`);
        tR += `- [ ] ${tache}\n`;
      } 
      %>
      
  3. Insérer le modèle dans une note :
    • Crée une nouvelle note et insère Liste de tâches.
    • Indique le nombre de tâches que tu souhaites lister (par exemple, 3).
    • Renseigne chaque tâche lorsque Templater te demande de les nommer.

👉 Résultat attendu :
Si tu indiques 3 tâches (par exemple : « Lire un livre », « Écrire une note », « Faire du sport »), tu obtiendras :

# Liste de tâches

- [ ] Lire un livre
- [ ] Écrire une note
- [ ] Faire du sport

Super ! Tu maîtrises désormais la création de listes dynamiques et les bases des boucles avec Templater. Passons à une étape encore plus puissante : utiliser des données externes ou des fichiers existants pour enrichir tes notes.


Étape 7 : Charger des données depuis un autre fichier

But de cette étape :
Créer un modèle qui récupère du contenu d’un autre fichier dans ton espace Obsidian et l’insère automatiquement dans une nouvelle note.


Instructions pas à pas :

  1. Créer un fichier source :
    • Dans ton dossier principal (ou un sous-dossier), crée un fichier nommé Source.md.
    • Ajoute-y le contenu suivant :
      Voici une liste d'éléments :
      - 🍎 Pomme
      - 🍌 Banane
      - 🍇 Raisin
      
  2. Créer un modèle pour importer le contenu :
    • Va dans ton dossier Templates et crée un fichier nommé Importer contenu.md.
    • Ajoute ce code :
      # Contenu importé  
      
      <%*  
      const contenu = await tp.file.include("Source.md");  
      tR += contenu;  
      %>
      
  3. Insérer le modèle dans une nouvelle note :
    • Crée une nouvelle note et insère Importer contenu.
    • Templater récupérera automatiquement le contenu du fichier Source.md et l’ajoutera à ta note.

👉 Résultat attendu :
Tu devrais obtenir une note avec ce contenu :

# Contenu importé

Voici une liste d'éléments :
- 🍎 Pomme
- 🍌 Banane
- 🍇 Raisin

Fantastique ! Tu avances à pas de géant et tu maîtrises maintenant des fonctionnalités avancées comme l’intégration de données externes. Pour la prochaine étape, on va voir comment combiner plusieurs techniques pour créer un modèle pratique qui automatise un workflow complet.


Étape 8 : Créer un modèle complet pour une revue quotidienne

But de cette étape :
Automatiser la création d’une revue quotidienne contenant :

  • La date du jour.
  • Une liste de tâches à remplir.
  • Du contenu extrait d’un fichier existant (comme des objectifs ou des citations inspirantes).

Instructions pas à pas :

  1. Créer un fichier de contenu fixe :
    • Crée un fichier nommé Citations.md dans ton dossier principal.
    • Ajoute-y quelques citations inspirantes :
      - "Le succès, c'est d'aller d'échec en échec sans perdre son enthousiasme." - Winston Churchill  
      - "Fais de ta vie un rêve, et d'un rêve, une réalité." - Antoine de Saint-Exupéry  
      - "La meilleure façon de prédire l'avenir, c'est de le créer." - Peter Drucker  
      
  2. Créer un modèle pour la revue quotidienne :
    • Va dans ton dossier Templates et crée un fichier nommé Revue quotidienne.md.
    • Ajoute ce code :
      # Revue du <% tp.date.now("YYYY-MM-DD") %>
      
      ## Objectifs pour aujourd'hui  
      - [ ]  
      - [ ]  
      - [ ]
      
      ## Citation inspirante  
      <%*  
      const citations = await tp.file.include("Citations.md").split("\n");  
      const citation = citations[Math.floor(Math.random() * citations.length)];  
      tR += citation;  
      %>
      
      ## Réflexion  
      - Ce que j'ai bien fait hier :  
      - Ce que je veux améliorer aujourd'hui :  
      
  3. Insérer la revue quotidienne :
    • Crée une nouvelle note et insère Revue quotidienne.
    • Observe comment la date du jour, une structure pour tes objectifs, et une citation aléatoire apparaissent automatiquement.

👉 Résultat attendu :
Si nous sommes le 2025-01-01, tu devrais obtenir quelque chose comme :

# Revue du 2025-01-01

## Objectifs pour aujourd'hui  
- [ ]  
- [ ]  
- [ ]  

## Citation inspirante  
- "Fais de ta vie un rêve, et d'un rêve, une réalité." - Antoine de Saint-Exupéry  

## Réflexion  
- Ce que j'ai bien fait hier :  
- Ce que je veux améliorer aujourd'hui :