Wikilinks and Backlinks
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.
Supported Wikilink Syntax
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
Relative Markdown File Links
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.
Inbound References (Backlinks)
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:
- The post’s file slug path (e.g.
autumn-in-kyoto) - The final segment of the file path
- The slugified title of the post
- The content collection ID
Where Backlinks Appear
- Header Metadata: If a post has inbound references, the total count appears in the post header metadata.
- Post Footer Section: At the end of the post, an
Inbound Referencessection lists all referring articles with direct links. - Archive Index: The post index on
/postsdisplays an inbound reference badge for linked articles.
Disabling Backlinks
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"