Native Wikilinks & Embeds — Design

First of three Obsidian-adoption features (then Obsidian Vault Import, then Live Preview & Daily Notes). Canonical spec: docs/superpowers/specs/2026-10-01-native-wikilinks-design.md.

Problem

Obsidian users type [[Note]] by reflex. Today it renders as literal text, the editor's [[ completion rewrites it to [Note](Note), and nothing that reads links (Page Graph, backlinks, rename) can see it.

Syntax

• [[T]], [[T|Alias]], [[T#Heading]], [[#Heading]] — links.
• ![[T]], ![[T#Heading]] — transclusion of a page or one section.
• ![[Owner/file.png|300]], ![[file.pdf]] — attachment embeds (current page when no owner).
• Never inside code; a target may not start with whitespace, so bash [[ -f x ]] in prose stays text.

Key decisions

• Resolution (WikiLinkResolver): exact name with plurals, then case-insensitive name, then case-insensitive title/alias from the structural title index; ties go to the lowest name. Applies to [[ ]] only — existing [Text](Page) links keep exact resolution.
• Rendering uses flexmark's wikilink extension and reuses the existing local-link output, so hover previews, createpage styling and SPA navigation work unchanged.
• Embeds render the target (or its section) inline, enforce the viewer's view permission, stop loops at depth 3, cap embedded size, and mark the render viewer-sensitive so it is never served from shared caches. A GET /api/pages/{name}/embed endpoint serves the editor preview.
• Every link consumer understands the syntax: reference graph (embeds count as references, so embedders' caches evict), rename (rewrites every form, keeps aliases), unlinked mentions, ?format=md (standard links for agents), excerpts, and Obsidian export.
• Editor: [[ completion now inserts native syntax; Ctrl-hover/Ctrl-click recognise it. A shared parity fixture keeps server and preview rendering identical.

Out of scope

Block references, vault-wide bare-filename attachment lookup, converting existing links, highlights and comments.