Obsidian Canvas Node Deep Linker

Canvas Node Deep Linker is an Obsidian plugin that automatically detects Canvas Node ID references inside markdown notes and turns them into interactive deep-links.

Clicking a link opens the target .canvas file, smoothly pans and zooms directly to the exact node, and highlights it with a temporary glow animation.

---

About

Obsidian Canvas allows visual mapping of notes, diagrams, and ideas. However, linking from standard Markdown notes to specific cards or text blocks inside a .canvas file has historically required manual navigation or full file links.

Canvas Node Deep Linker bridges the gap between structured text notes and visual diagrams:

1. Seamless References: Write node references such as (Canvas-Knoten 840a8fc46f115e05) or (Canvas-Knoten 23c95438ec7ed252) directly in your notes.
2. Automated Discovery: The plugin indexes your entire vault in real time, mapping every node ID to its parent Canvas file and title automatically.
3. Instant Deep Navigation: One click opens the canvas view and focuses directly on the target card with camera panning and visual highlighting.

---

Features

• Vault-wide Auto-Indexing: Automatically maps every Canvas Node ID (16 hex chars) across your vault to its parent .canvas file and node title. No manual file paths required.
• Auto-Link Generation: Converts references like (Canvas-Knoten 840a8fc46f115e05) or (Canvas-Knoten 23c95438ec7ed252) into interactive link badges.
• Live Preview & Reading View Support: Renders interactive buttons seamlessly in both Live Preview (Editing Mode) and Reading View.
• Smooth Deep Navigation: Opens the .canvas file, focuses the node, zooms to selection, and flashes a pulsing glow outline for 3 seconds.
• Right-Click Context Menu: Right-click any node inside an Obsidian Canvas to copy a link like (Canvas-Knoten nodeId) directly to your clipboard.

---

Usage

1. Referencing a Node in Markdown Notes

Write any node reference in your markdown notes:

(Canvas-Knoten `23c95438ec7ed252`)

or

(Canvas-Knoten 840a8fc46f115e05)

The plugin automatically transforms this text into a clickable link pill: Canvas-Knoten 23c95438ec7ed252 (Wahrheitstafel)

2. Copying a Node Link from Canvas

1. Open any .canvas file in Obsidian.
2. Right-click on any card, group, or text node.
3. Select "Link zu diesem Knoten kopieren".
4. Paste the link anywhere in your notes.

---

Installation

Community Plugin Store (Pending Approval)

1. Open Obsidian Settings → Community Plugins.
2. Search for Canvas Node Deep Linker.
3. Click Install and then Enable.

Manual Installation

1. Download manifest.json, main.js, and styles.css from the latest GitHub Release.
2. Create a directory .obsidian/plugins/canvas-node-deep-linker/ inside your Obsidian vault.
3. Copy the downloaded files into .obsidian/plugins/canvas-node-deep-linker/.
4. Reload Obsidian and enable the plugin in Settings → Community Plugins.

---

Development & Building

# Clone the repository
git clone https://github.com/kevinkaupert/obsidian-canvas-node-deep-linker.git
cd obsidian-canvas-node-deep-linker

# Install dependencies
npm install

# Build production bundle
npm run build

# Watch mode for active development
npm run dev

---

License

Distributed under the Full MIT License.