| name | inteligir-links |
| description | Wiki links, heading anchors, aliases, id-resolved links, external links, embeds, and vault media in inteligir notes. |
inteligir Links
Wiki links move between notes in the vault. Markdown links go out to the web.
Image syntax is for something that should render, not for something to click.
Wiki Links
[[Queue Design]]
[[Queue Design#Rollback]]
[[#Rollback]]
[[Queue Design|the design note]]
[[Queue Design|9e64c3df-c1e2-4a4d-8c07-91528f422413]]
The body of a wiki link is target, then an optional #heading, then an
optional |alias — and the LAST pipe starts the alias, so a title
containing a pipe still works.
An alias shaped like a uuid is not a label: it is the target note's identity,
written when the app resolved the link. It keeps pointing at the right note
after a rename, and the reader sees the note's title, never the uuid. Never
type one yourself, and never replace one with a display alias — you would be
throwing away the only durable pointer in the link.
Resolution walks: exact path, then filename, then path suffix, then frontmatter
aliases. A link that resolves to nothing renders dashed and offers to create
the note — that is a working state, not an error, and it is the right way to
write toward a note that does not exist yet.
Rules worth the keystrokes:
- Match the target's real filename. Check it; do not guess from a heading.
[[#Heading]] stays inside the current note.- Escape a literal hash in a title as
\#; a # surrounded by spaces is title
text, not an anchor.
- A
# anchor matches the heading loosely (case and spacing are forgiven). If
two headings collide, link the section a different way rather than shipping an
ambiguous anchor.
- Wiki links do not render inside comment text. In a comment, name the note in
prose.
External Links
[the RFC](https://example.com/rfc)
Use a label that says where it goes. Preserve existing destinations exactly.
Never author javascript:, data:, file:, or a URL carrying credentials.
Embeds And Media
| Intent | Syntax |
|---|
| Transclude another note | ![[Some Note]] |
| Image from the vault |  |
| Video, tweet, or page card |  |
![[Some Note]] pulls that note's content in for reading; it does not copy the
bytes, so the source note stays the one place to edit it.
Vault media lives under assets/ and is referenced by that relative path. Do
not write file:// or absolute local paths — they break for every other person
and every other machine that opens the vault.
Before You Finish
- Every wiki target names a real file, or is deliberately dashed.
- Existing uuid aliases and heading anchors are untouched.
- External destinations are unchanged and use a safe scheme.
- Media uses a vault-relative
assets/ path.
