Wiki Links
Wiki links connect your notes. Type [[ to link to another note, ![[ to embed an image, or [[page^block]] to reference a specific block.
Creating links
Section titled “Creating links”Type [[ and an autocomplete dropdown appears with all notes in your workspace. Start typing to filter by filename or path. Press Enter or click to insert the link.
[[My Note]]The autocomplete:
- Shows up to 30 results
- Scores same-folder files higher
- Matches on filename and file path
- Uses first-character caching for instant results
When you select a file, Lokus inserts a link in the format [[path|display name]]. The display name is the filename without the .md extension.
Link syntax
Section titled “Link syntax”Basic link
Section titled “Basic link”[[Note Title]]Links to a file named Note Title.md in your workspace.
Link with alias
Section titled “Link with alias”[[path/to/note|Custom Display Text]]The text after | is what appears in the editor. The path before | is used for resolution.
Heading link
Section titled “Heading link”[[Note Title#heading-name]]Links to a specific heading within a note. The # separator works like a URL hash.
Block reference
Section titled “Block reference”[[Note Title^block-id]]Links to a specific block (paragraph, list item, etc.) within a note. Type [[Note Title^ and the autocomplete switches to block mode, showing all blocks in that file.
If the target block does not have an explicit block ID, Lokus generates one and writes it back to the source file when you select it.
Image embeds
Section titled “Image embeds”Type ![[ to embed an image. The autocomplete shows image files in your workspace (PNG, JPG, JPEG, GIF, WebP, SVG, BMP, AVIF).
![[photo.png]]You can also paste a URL inside ![[:
![[https://example.com/image.png]]The image renders inline in the editor. If an external image fails to load, a placeholder appears with a link to the URL.
Block embeds
Section titled “Block embeds”Embed a specific block from another note:
![[Note Title^block-id]]This renders the referenced block’s content inline in the current note.
Canvas links
Section titled “Canvas links”Type ![ (single bracket, not double) to link to a canvas file. The autocomplete shows .canvas files in your workspace. Selecting one inserts a canvas link node that shows a preview of the canvas.
Backlinks panel
Section titled “Backlinks panel”The backlinks panel shows every note that links to the current note. Open it from the sidebar.
It has three sections:
Linked mentions
Section titled “Linked mentions”Notes that contain a [[wiki-link]] pointing to the current file. Each backlink shows the source filename and the surrounding context.
Block backlinks
Section titled “Block backlinks”Notes that reference specific blocks in the current file using the ^block-id syntax.
Unlinked mentions
Section titled “Unlinked mentions”Notes that mention the current file’s name in plain text but do not have a wiki link. These are potential links you might want to formalize.
Link resolution
Section titled “Link resolution”When you create a wiki link, Lokus resolves the target asynchronously:
- Checks the workspace file index for a matching filename or path
- Resolves relative paths from the current file’s directory
- For image embeds, reads the file and converts it to a data URL for display
- For external URLs (starting with
http://orhttps://), uses the URL directly
If duplicate filenames exist in different folders, the autocomplete inserts a path prefix to disambiguate. Root-level files with duplicates get a ./ prefix.
Hover preview
Section titled “Hover preview”Hover over any wiki link for 500ms and a preview popup appears showing the linked note’s content. Move your mouse away to dismiss it.
Click to navigate
Section titled “Click to navigate”Click any wiki link to open the linked note. The editor dispatches an open-file event that the workspace handles — it opens the file in the current editor tab or creates a new tab.