Wikilinks

Wikilinks

A data-wikilink span renders as a monospace, blue-tinted reference — the HTML equivalent of [[Note Name]]. A dotted underline signals "this is a link to somewhere else in the graph".

When the target note doesn't exist, add data-unresolved. The link dims to muted text — the standard visual convention for broken wikilinks in knowledge tools.

<span data-wikilink>Session Protocol</span>
<span data-wikilink data-unresolved>Missing Note</span>

Result: Session Protocol · Missing Note

Wrap in <a> when the target page exists:

<a href="session.html" data-wikilink>Session Protocol</a>

Result: Session Protocol

Resolved vs unresolved

Tags

Vault tags map to data-tag. The attribute prepends a # automatically — don't include it in the element text. Renders in accent blue, monospace, slightly smaller than body text.

<a href="/tags/autonomous" data-tag>autonomous</a>
<span data-tag>deep</span>
<span data-tag>vault</span>

Result: autonomous deep vault

Use <a> when the tag links to a filtered view. Use <span> for display-only tags.

Tag clusters

Multiple tags sit naturally inline:

<p data-text="mono">
  session: complete —
  <span data-tag>autonomous</span>
  <span data-tag>deep</span>
  <span data-tag>vault</span>
</p>

Git hashes

data-hash renders a git commit hash — monospace, muted colour, slightly tighter letter-spacing. Designed for provenance displays where a piece of content needs to be traceable to a specific commit.

<span data-hash>a3f7b2c</span>

Result: a3f7b2c

Use in session metadata, changelog entries, or anywhere a commit reference adds traceability without demanding attention:

<p>
  Last updated: <span data-session-meta>2026-03-27</span>
  <span data-hash>a3f7b2c</span>
</p>

Result: Last updated: 2026-03-27 a3f7b2c

In context

These three attributes often appear together in exported vault content. A note backlink section might look like:

Reference