Wikilinks let you link between notes using [[double brackets]], just like in Obsidian. nuartz resolves these links at build time and renders them as clickable links with graph view connections.
Syntax
Basic Link
[[docs/getting-started]]Renders as: docs/getting-started
The link text defaults to the note's title. The path is relative to the content/ directory.
Custom Display Text
[[docs/getting-started|Get Started Guide]]Renders as: Get Started Guide
Use the pipe | to set custom link text.
Heading Anchor
[[docs/authoring-content#Frontmatter]]Renders as: docs/authoring-content > Frontmatter
Link directly to a specific heading within a note.
Combined
[[docs/authoring-content#Frontmatter|See frontmatter docs]]Renders as: See frontmatter docs
Image Embeds
Embed images using the ! prefix:
![[my-image.png]]With dimensions:
![[my-image.png|400x300]]How It Works
nuartz resolves wikilinks during the Markdown-to-HTML transformation:
- The parser finds
[[...]]patterns in your Markdown - It looks up the target file in the content directory
- It generates a proper
<a>link with the resolved URL - The link is registered for graph view and backlinks
Obsidian Compatible
nuartz uses the same wikilink syntax as Obsidian, so your notes work in both environments without changes.
Related
- Authoring Content — full syntax reference
- Graph View — see how wikilinks build your note graph
- Configuration — enable or disable wikilinks