Waypoint Obsidian : generer des index de dossiers

Un index de fiches de notes classées par niveaux sur une feuille ivoire.

Waypoint crée un index des fichiers d’un dossier Obsidian, conservé dans une note de dossier. Les liens se mettent à jour quand vous ajoutez ou renommez une note. Ce tutoriel vous fait construire un petit dossier de démonstration, puis vérifier son index. Pour situer cet usage parmi les autres méthodes, consultez les outils de structuration et de MOC dans Obsidian.

Introduction à Obsidian et au plugin Waypoint

Qu’est-ce qu’Obsidian et pourquoi structurer vos notes ?

Obsidian est un outil de prise de notes basé sur Markdown, conçu pour les professionnels et les passionnés de gestion de connaissances. Il transforme vos fichiers texte en un système de gestion dynamique et interconnecté. En d’autres termes, il agit comme un second cerveau numérique, offrant la possibilité de structurer, relier et visualiser vos idées sous forme de graphes ou de réseaux.

Structurer vos notes dans Obsidian ne se limite pas à une simple organisation. Cela vous permet de retrouver rapidement des informations pertinentes, d’identifier des relations entre des idées et de construire un référentiel de savoir évolutif. Par exemple, un consultant qui documente ses projets peut relier des concepts clés, des méthodologies ou des retours d’expérience pour en tirer des enseignements concrets.

Mais sans une structure claire, vos notes peuvent rapidement se transformer en un amas désordonné. C’est là qu’interviennent des plugins comme Waypoint, qui vous aident à générer des vues organisées et accessibles de vos fichiers.

Ce que Waypoint indexe

Waypoint relie les notes d’un dossier et de ses sous-dossiers. Dans la configuration utilisée ici, la note qui porte l’index se trouve dans le dossier et porte le même nom que lui : Demo Waypoint/Demo Waypoint.md.

Un index de fichiers : chaque lien ouvre une note. Les titres H1, H2 et H3 à l’intérieur des notes ne deviennent pas des entrées de cet index.
Un résultat en Markdown : les liens générés restent enregistrés dans la note.
Une zone entretenue par le plugin : son contenu est régénéré lorsque les fichiers du dossier changent.

Pour naviguer entre les titres d’une seule note, utilisez le panneau Plan (Outline) natif d’Obsidian. Waypoint répond au besoin de naviguer entre plusieurs fichiers.

Configurer Waypoint pour créer un index de dossier

Installation et activation du plugin dans Obsidian

L’installation de Waypoint dans Obsidian est une opération rapide et intuitive. Voici les étapes clés pour intégrer ce plugin à votre espace de travail :

Ouvrez la section « Paramètres » d’Obsidian : Cliquez sur l’icône des paramètres (⚙️) en bas à gauche de l’interface.
Accédez à la section « Plugins de la communauté » : Activez d’abord les plugins de la communauté, si ce n’est pas déjà fait. Une notification de sécurité peut apparaître, confirmant que les plugins tiers ne sont pas officiellement vérifiés par Obsidian.
Recherchez Waypoint : Dans le répertoire des plugins, entrez « Waypoint » dans la barre de recherche. Une fois trouvé, cliquez sur « Installer ».
Activez le plugin : Une fois installé, retournez dans la liste des plugins et activez Waypoint en le basculant sur « ON ».

Faites ce premier essai dans un coffre de test. La recette ci-dessous a été exécutée sous Windows avec Obsidian 1.14.0 et Waypoint 3.0.1 le 8 septembre 2026, avec les réglages par défaut du plugin. Aucun appareil mobile réel n’a été testé.

Créer un dossier de trois notes et son index

Créez un dossier nommé Demo Waypoint.
Dans ce dossier, créez trois notes : Alpha.md, Beta.md et Gamma.md. Leur contenu peut être une simple phrase.
Créez dans le même dossier une quatrième note, Demo Waypoint.md. Son nom doit correspondre exactement au nom du dossier.
Ouvrez cette note en mode édition. Écrivez une phrase de contexte, laissez une ligne vide, puis tapez %% Waypoint %% sur sa propre ligne, avec les espaces et les doubles signes pour cent.
Attendez la génération : le marqueur est remplacé par une zone contenant les liens [[Alpha]], [[Beta]] et [[Gamma]], encadrée par %% Begin Waypoint %% et %% End Waypoint %%. En mode lecture, les commentaires sont masqués et les liens restent visibles.

Vérifiez le résultat : ouvrez un lien, puis revenez à l’index. Ajoutez Delta.md dans le dossier : son lien doit apparaître. Ouvrez Alpha pour quitter l’index, puis renommez Beta.md en Beta renommée.md. Dans ce dossier de test sans liens manuels, si Obsidian demande de mettre à jour les liens internes, choisissez Ne pas mettre à jour : laissez Waypoint régénérer son index. Rouvrez l’index : le nouveau nom doit apparaître une seule fois, sans texte parasite après le lien.

Dans la seconde exécution de ce test, l’ajout et le renommage ont produit quatre liens propres et résolus. Le texte placé avant et après la zone générée est resté présent. Un premier essai avec la mise à jour des liens par Obsidian avait laissé un suffixe parasite ; cette variante n’est pas validée.

Préserver votre texte et diagnostiquer un échec

Écrivez hors de la zone générée : gardez vos commentaires avant %% Begin Waypoint %% ou après %% End Waypoint %%. Une modification manuelle entre ces balises peut être écrasée lors de la prochaine mise à jour.
Si rien n’apparaît : contrôlez que le plugin est actif, que le marqueur est exact et que la note porte le même nom que son dossier. Faites l’essai dans un sous-dossier du coffre, pas à sa racine.
Si vous renommez le dossier : vérifiez aussi le nom de sa note d’index. La recette dépend de leur correspondance.
Pour revenir en arrière : désactivez Waypoint, puis retirez la zone générée de la note de test si vous ne voulez plus cet index. Ne supprimez pas les notes vers lesquelles il pointe.

Quand cet index de dossier est utile

Waypoint convient à un ensemble dont le classement par dossiers est déjà pertinent : notes d’un projet, chapitres d’une documentation ou documents d’une recherche. Vous pouvez ajouter une introduction rédigée autour de l’index pour expliquer ce que contient le dossier.

Une MOC éditoriale peut sélectionner des liens et expliquer leurs relations au-delà des dossiers. Waypoint fournit une liste structurée par emplacement ; le sens des liens reste à écrire. Vous pouvez commencer par le petit dossier ci-dessus avant d’automatiser d’autres modèles.

Les règles du marqueur, des notes de dossier et de la zone générée sont décrites dans la documentation de Waypoint. La présente recette valide la génération, l’ajout et le renommage dans un dossier simple ; elle ne valide pas les variantes de notes de dossier, les index imbriqués ou la synchronisation entre appareils.