Obsidian est fantastique parce qu’on peut relier à peu près tout à n’importe quoi :

  • Bien entendu, relier ses notes entre elles avec des [[liens wiki]],
  • Cibler un lien vers un paragraphe spécifique grâce à un lien vers un [[^bloc]],
  • Et aussi cibler un titre ou en-tête de niveau inférieur dans une note [[#comme suit]].

Voir la doc officielle (très bien fichue) pour en savoir plus.

Or, une base de connaissances est appelée à évoluer constamment. Les notions se raffinent, les documents vivent, des sections deviennent des notes à part entière – pour vous faciliter la vie, prenez soin d’avoir activé le compositeur de note (plugin principal fourni avec l’application). Mais que deviennent alors ces liens, notamment si l’on renomme ses fichiers, modifie son texte, ses titres ?

  • Si l’on change le nom d’un fichier dans Obsidian, les liens entre notes y sont renommés à la volée tant qu’on a pris soin d’activer l’option correspondante dans les préférences (section Fichiers & Liens). Pas de risque de perdre de l’information.
  • Puisque les liens aux paragraphes ciblent un code alphanumérique type ^e5gh8ç, on peut altérer le texte autour tant qu’on veut, rien ne cassera non plus tant que le code reste intact. Et si, mesure drastique, on souhaite supprimer le paragraphe, la présence même de ce petit code montre que l’on risque de casser des liens : à nous de visiter les références pour décider si cette information vaut la peine d’être conservée.

Les liens aux en-têtes, en revanche, cassent toujours. Supposons que j’ai une fiche Observations culinaires diverses avec un en-tête ### Le saucisson n'existe pas en Australie, vers lequel j’aurais créé un lien depuis une autre fiche intitulée Parcours personnel de deuil (Chut. Chacun ses priorités).

À présent, imaginons (tout ceci est bien entendu absolument fictif) que j’aie eu vent d’un moyen de me procurer la Nourriture des dieux dans le pays de Bluey. Très logiquement, mon en-tête dans Observations culinaires diverses se trouve renommé ### Comment me procurer du saucisson en Australie. Que devient le lien vers celui-ci dans Parcours personnel de deuil ? Il casse, car un lien vers un en-tête utilise le texte de cet en-tête. Si ce texte change, le lien perd son point d’atterrissage dans le fichier. En effet, l’application ne surveille pas ces opérations de renommage : elles nuiraient fortement à sa performance. Si l’on souhaite renommer un en-tête, il faut passer explicitement par le menu contextuel de celui-ci (clic-droit > Renommer cet en-tête), ce qu’on ne manquera pas… d’oublier de faire.

Du coup, comment éviter de voir ses liens casser ? Doit-on s’astreindre à renommer manuellement ses en-têtes avec l’option de menu, ce qui est drôlement fastidieux ? Ou bien s’abstenir à jamais de les utiliser comme cible de ses liens ?

Un petit plugin tout simple et parfaitement méconnu résout ce problème : Header backlinks. Si un lien pointe vers un en-tête, celui-ci présente alors une ancre bien visible dans la marge :

Offrant un rappel tangible de sélectionner manuellement l’option de menu Renommer cet en-tête avant de, eh bien, renommer cet en tête. Ailleurs, pas de risque.