-
Notifications
You must be signed in to change notification settings - Fork 0
wikilinks
A wikilink references another concepts/pages by path:
See [[concepts/backlinks]] for the reverse.
Or with display text: [[concepts/backlinks|reverse links]].Wikilinks are first-class — the architecture/wiki-engine parses them during indexing, stores them in a links(source, target) table, and powers both the concepts/backlinks and the architecture/web-ui from that table.
| Syntax | Meaning |
|---|---|
[[concepts/pages]] |
Linked text and target are both concepts/pages
|
[[concepts/pages|pages]] |
Display "pages", target concepts/pages
|
[[Welcome]] |
Resolves to Welcome.md at the wiki root |
[[non/existent]] |
Renders as red — broken link |
Standard markdown [label](url) works for external links and intra-page anchors, but encodes the path inside the text. When you guides/refactoring-a-wiki, every (./path/to/old.md) reference breaks silently.
[[target]] makes the relationship explicit: it's a wiki link, not a generic URL. The architecture/index-and-search tracks every one, and agents/mcp-tools can rewrite them in place.
In the architecture/web-ui, wikilinks render as reference edges (accent-colored, with arrowheads) distinct from path-hierarchy edges. See design/wikilinks-as-graph for the longer story.