Skip to content

Wikilinks and Backlinks

2 min read332 words

Tiny provides first-class support for interconnected personal notes. Writing links between articles feels native to Obsidian or Roam, while compiling to standard, accessible HTML links at build time with zero client JavaScript.

Tiny’s Markdown pipeline recognises standard Obsidian-compatible wikilinks:

Syntax Output Route Example
[[Post Title]] /posts/post-title [[Autumn in Kyoto]]
[[Post Title|Custom Label]] /posts/post-title with alias text [[Autumn in Kyoto|Kyoto morning]]
[[Post Title#Section Heading]] /posts/post-title#section-heading [[Autumn in Kyoto#Fushimi in the Mist]]
[[#Section Heading]] #section-heading (same-page jump) [[#supported-wikilink-syntax]]

Important: Route Scope Limitation

If your notes are authored in a local folder with relative file links, Tiny automatically converts them during build:

See [local software](./local-first-software.md) or the [guide](../posts/autumn-in-kyoto.md#fushimi-in-the-mist).

This compiles cleanly to:

<a href="/posts/local-first-software">local software</a>

You can keep your links working both inside your local Markdown editor and on the published web.

When one post links to another (via a wikilink, relative Markdown link, or root-relative post path), Tiny builds an in-memory bi-directional link graph during static compilation.

Matching Criteria

When calculating backlinks for a post, Tiny matches references against:

  1. The post’s file slug path (e.g. autumn-in-kyoto)
  2. The final segment of the file path
  3. The slugified title of the post
  4. The content collection ID
  1. Header Metadata: If a post has inbound references, the total count appears in the post header metadata.
  2. Post Footer Section: At the end of the post, an Inbound References section lists all referring articles with direct links.
  3. Archive Index: The post index on /posts displays an inbound reference badge for linked articles.

Backlinks can be toggled in your site configuration:

features:
  backlinks: false # Default is true

The UI heading can be customized in the ui configuration domain:

ui:
  inboundReferences: "Mentioned In"