An easy mistake to make, especially when trying to disambiguate between two same-named notes, is to use a 'partial' path, such as in citing container name/note name
. Although not illegal usage, this does not necessarily get parsed as the user assumes. The logic runs like this:
- If the path argument is an attribute value, that value is evaluated. If the path is quoted, the quoted expression is evaluated and used. Else…
- If the path argument is a designator (e.g. 'parent'), use the designator. Else…
- If the path argument starts with a '/', it is evaluated relative to the root of the document. If not, it is evaluated relative to the current note (though such relative paths are not generally recommended). If the absolute or relative path locates a note that exists, use that note. Else…
- If the path argument designates a note that is an immediate child of this note, use it. Else…
- If the path argument designates any note in the document whose title ($Name) exactly matches the note, use it.
Bottom line: do not use partial paths as shorthand. Use a full path or a relative paths as described above.