Silica Docs

Links

Connect pages with Obsidian-style wikilinks.

Wikilinks are the main way to connect pages in your vault. Write them exactly as you would in Obsidian, and Silica turns them into working links.

Markdown
[[other-page]]
[[folder/other-page]]
[[other-page|Custom label]]

Links you create this way also power the backlinks shown at the bottom of each page.

Linking to a heading or block

Point a link at a specific heading or paragraph using an Obsidian fragment:

Markdown
[[other-page#Install guide]]
[[other-page#^important-block|Important block]]

To make a paragraph linkable, add a block ID (a caret and a label) at its end:

Markdown
This paragraph can be linked directly. ^important-block

This paragraph is a real, linkable block used by the example below.

Live examples: jump to this heading and jump to that block.

Block IDs are useful when a whole heading is too broad but one specific paragraph, list item, or callout should be linkable.

Set your preferred matching strategy in silica.config.ts:

TypeScript
wikilinks: {
  strategy: "shortest", // "absolute" | "relative" | "shortest"
  strict: false,
}
StrategyBehavior
shortestMatch by filename, preferring the nearest page when names repeat (default)
absoluteResolve from the vault root
relativeResolve relative to the current page

With strict: true, unresolved links fail the build so you can fix them before publishing.

If a wikilink points at a page that does not exist, Silica renders it as a muted, non-clickable link instead of failing the build. Create the target page or fix the path to resolve it.

Standard Markdown links to other sites work as usual and open in a new tab:

Markdown
[Shiki](https://shiki.style/)

Embedding instead of linking

Prefix a wikilink with ! to embed the target — an image, a file, or another page — directly into the current page. See Embeds and assets.

Backlinks