Wiki-Links

April 16, 2026 · 1 min read

Contents

Basic link
Alias / custom display text
Heading anchor
Block reference
Resolution order
Cross-section links
Section homepage links
Aliases
See also

OnyxFolio resolves [[wiki-links]] server-side during the two-pass vault load. All standard Obsidian link forms are supported.

Basic link

[[Note Title]]

Renders as a link to the note titled "Note Title". Display text defaults to the note title.

Alias / custom display text

[[Note Title|Display Text]]

The part after | becomes the link text. The target is still resolved by title.

Spaces around the | are allowed — both forms are equivalent:

[[Note Title|Display Text]]
[[Note Title | Display Text]]

Heading anchor

[[Note Title#Section Heading]]

Links to a specific heading within the target note. The anchor is slugified (lowercased, spaces → hyphens).

Display text defaults to Note Title › Section Heading. Override with |:

[[Note Title#Section Heading|Read this section]]

Block reference

[[Note Title^block-id]]

Links to a specific block (paragraph) tagged with ^block-id in the target note. See Obsidian Syntax for how to create block IDs.

[[Note Title^block-id|Custom label]]

Resolution order

OnyxFolio builds a URL index during Pass 1 of the vault load. Each note is indexed under three keys:

slugify(title) — matches [[Note Title]]
slugify(filename without .md) — matches by filename even when title differs
frontmatter slug — matches the slug directly
aliases — each alias is indexed as a separate key

This means [[Filename|Display]], [[Title]], and [[slug]] all resolve correctly even when the three differ.

If a target is not found in the index, OnyxFolio falls back to /<slugified-title> — the link is still generated, it just may 404.

Cross-section links

Wiki-links resolve correctly across sections. A link from blog/My Post.md to gallery/Photo.md generates /gallery/photo — no need to include the section prefix.

Section homepage links

Links to notes registered as type: homepage or type: listing resolve to the section URL, not the file's computed slug URL. For example, [[Blog]] resolves to /blog, not /blog/blog.

Aliases

Add aliases: to a note's frontmatter to register additional link names:

aliases:
  - my alternate name
  - another alias

Any of these names can then be used in [[wiki-links]] from other notes.