NAME

wiki-syntax - How to link entries, alias them, and read the backlink counts.

Also resolves as: wikilinks, link syntax

Entries are plain Markdown in src/content/wiki/, same as start-here and everything else. The filename becomes the URL. On top of ordinary Markdown, one extra piece of syntax:

Linking

[[wiki-syntax]]              -> links, shows "wiki-syntax"
[[wiki-syntax|this page]]    -> links, shows "this page"

Targets are matched loosely, against the filename, the title, and any aliases, so [[Wiki syntax]], [[wiki-syntax]] and [[WIKI SYNTAX]] all land here. Case and punctuation don’t matter.

Links inside backticks are left alone, which is how the examples above survive.

Aliases

The aliases field in the frontmatter registers other names for the same entry, so an acronym, a plural, or an old title keeps resolving:

aliases:
  - wikilinks
  - link syntax

Reading the index

Each row on the wiki index begins with two numbers in the address column. 2←5→ means two entries link here and this one links out to five. High inbound counts mark the ideas everything else leans on.

Links from the posts

Posts link into the wiki without being edited. When an entry is published, the first time its title or one of its aliases appears in a post, that phrase becomes a link, once per post. A post can opt out with autolink: false in its frontmatter. Draft entries do not link, so a stub can sit in the wiki folder until it is written.

A link to something unwritten, like orphan note, stays inert and grey instead of 404ing, and gets listed under Wanted on the index until the entry exists.

Where links work

The plugin runs over all Markdown on the site, not just this folder, so a log post or a project write-up can point into the wiki with the same double-bracket syntax.

meta

start-here(7)

seedling, last revised 2026.09.06.
a rough note, likely to change