Skip to content

Wikilinks#

You know how a Wikipedia article says "The French Revolution (1789–1799) was a period of radical political and societal change in [[France]] that had a major impact on [[Europe]]"?

Those blue links inside [[double brackets]] are called wikilinks. In your LLM Wiki, they work the same way — but instead of pointing to wikipedia.org, they point to another .md file in your wiki/ folder.

Syntax#

[[Page Title]]                → links to wiki/page-title.md
[[Page Title|display text]]   → shows "display text" but links to Page Title

The | is like an alias for the link text. You'd use it when the natural sentence reads better with different words: "Ride the [[TransJakarta Busway|busway]] to Pasar Baru."

How They Get Created#

  1. At ingest time — the script scans new pages and auto-links any text that matches an existing page title or alias. If your wiki already has a "TransJakarta Busway" page and you write "The busway is the cheapest option", the script turns it into "The [[TransJakarta Busway|busway]] is the cheapest option."

  2. Manually — you can write [[Any Concept]] by hand. If the page exists, it's a link. If it doesn't... keep reading.

If you write [[Banana Republic]] but no wiki page called "banana-republic.md" exists, that's a broken wikilink. The lint script flags it in its report:

BROKEN | My Page | [[Banana Republic]] not found

This is a feature, not a bug. It tells you: "Hey, you referenced something that isn't in your wiki yet. Maybe you should create it." It's a TODO list woven into your knowledge base.

Why Not Just Use File Paths?#

[[wikilinks]] resolve by title, not by filename. This means: - You can rename a file — as long as the frontmatter title: stays the same, all links still work. - You can move files between folders — links don't break because they don't use paths. - The link text is human-readable, not a file path.

Remember: [[wikilinks]] turn a pile of markdown files into a web of connected ideas. Without them, you just have a folder of text files.