Obsidianguide   ›   Anhang   ›   Glossar   ›   Referenzlink

Referenzlink

Ein Referenzlink ist eine Variante der Markdown-Linksyntax, bei der die eigentliche URL ausgelagert wird. Statt [Text](URL) schreibst du [Text][Name] und definierst die Zieladresse an einer anderen Stelle im Dokument:

[ObsidianGuide][guide]

[guide]: https://obsidianguide.de

Referenzlinks wurden ursprünglich entwickelt, damit Markdown-Texte besser lesbar bleiben. Der Referenzlink „stört“ weniger beim Lesen des als Quelltext und kann bequem am Ende der Datei gepflegt werden. Sie eignen sich besonders, wenn dieselbe URL mehrfach im Text vorkommt.

Obsidian unterstützt die klassische Referenzlink-Syntax vollständig. Die Linkdefinitionen werden beim Rendern erkannt und korrekt verknüpft. Wie bei normalen Markdown-Links gilt auch hier:

  • Der Anzeigename ist frei wählbar
  • Die Link-Labels müssen innerhalb einer Datei eindeutig sein
  • Die URL kann lokal sein (file:///), extern sein oder einen Dienst wie mailto: oder ftp: verwenden

#Besonderheit in Obsidian

Referenzlinks funktionieren ausschließlich für klassische Markdown-Links.

Die Obsidian-eigene Wikilink-Syntax ([[Notiz]] oder ![[Bild.png]]) unterstützt keine Referenzlink-Definitionen.

Wenn du also interne Notizen verlinken möchtest, bleibst du bei Wikilinks.

Wenn du externe Ressourcen strukturierter verwalten willst, sind Referenzlinks eine gute Wahl.

Vorteile

  • Sauberer, gut lesbarer Text
  • Zentrale Pflege aller URLs
  • Besonders geeignet für veröffentlichte Markdown-Artikel, Blogposts oder Dokumentationen