← Overview
How Obsitex names the cross-reference labels it generates, and how it resolves your wikilinks — plus the one naming rule that keeps links from breaking.
Every # heading gets an automatic \label. Obsitex derives it from the file path plus the heading text (lowercased, and path-prefixed so two identically named headings never collide). You never write these labels yourself — you just link to a heading and Obsitex fills in the reference. See Links & cross-references.
The file part of a wikilink — Note in [[Note#Heading]] — is matched purely by path and file name: the full path, the path without .md, or the bare file name (including any number prefix), each lowercased.
[[Note]] (no heading) points to the first # heading of that file.# heading cannot be linked — the link falls back to plain text.title: and aliases: properties are not used to resolve links. Linking works only through the real file name.Because links resolve by file and path name, renaming a file outside Obsidian breaks any [[wikilink]] pointing to it (and can break the Flexplorer order too). Rename inside Obsidian — which updates the links for you — or update the links (and the Flexplorer data) in the same step.
01 , 02 ) — they are part of the file name that links rely on.# lines, the file name itself never appears in the PDF — a cross-reference shows text like "Section 3.2", not the file name.