options:
linking: [frontmatter, aliases, path] # defaultAs with detection: tried in that order, the first match wins.
Frontmatter
Two spellings. The shorter one is a shared key on both pages:
---
title: Kaffee
translationKey: kaffee
---The fuller one names the partners directly — useful when only one page should be touched:
---
title: Kaffee
translations:
en: en/notes/coffee
---Wikilinks are allowed there: en: "[[en/notes/coffee]]".
Aliases
If a page carries an alias matching the title or file name of a page in another language, the two count as translations:
---
title: Kaffee
aliases: [Coffee]
---That is exactly what the Obsidian plugin
Multilingual writes: it stores translated note
names as ordinary aliases. Anyone working with it gets the linking for free.
Together with switcher.label: translatedTitle the switcher then says “Coffee” on the German page
and “Kaffee” on the English one.
Path
Same base path, different language — done. de/notizen/kaffee and en/notizen/kaffee find each
other with no declaration at all, and so do guide.md and guide.de.md.
The quietest way, and for sites that do not translate their file names the only one needed.
The precedence
If a page holds a translationKey and a path matched at the same time, the frontmatter wins — it is
the explicit statement. Which is why frontmatter comes first in the default.
Changing the order changes which statement counts in case of doubt:
options:
linking: [path, frontmatter] # the path beats the frontmatter