Semantic Auto-Linker

Semantic Auto-Linker is an Obsidian community plugin for safe, reviewable wiki-link insertion with optional local semantic retrieval.

It focuses on two things:

• safe inline linking with review before write
• vault-wide review with graph impact and semantic exploration

Features

• Analyze the current note and review suggested inline [[links]]
• Analyze the whole vault and review suggestions before applying
• Exclude noisy target notes directly from review rows or settings
• Switch insertion mode per review:
  • Inline updates matched text in place
  • Footer writes accepted targets into a footer section
• Strong safety rules:
  • skip frontmatter
  • skip fenced code and inline code
  • skip existing wikilinks and Markdown links
  • skip self-links
  • avoid duplicate link targets in the same note
• Deterministic matching for titles, aliases, normalization, and acronyms
• Optional semantic retrieval with a local Ollama embedding model
• Embedding explorer with PCA note/concept views
• Persistent whole-vault review state with background refresh when notes change

Semantic mode

Semantic mode is enabled by default and local-first.

Current provider support:

• Built-in local model through Transformers.js
• Ollama

Typical setup:

1. In Obsidian, open Settings → Community plugins → Semantic Auto-Linker.
2. Keep Semantic provider set to Local model (built-in).
3. Run Build semantic embeddings. The default local model downloads automatically on first use and is cached locally.

Optional Ollama setup:

1. Install and run Ollama.
2. Pull an embedding model, for example:
   • ollama pull embeddinggemma
3. Select the Ollama provider and model.
4. Run Build semantic embeddings.

Privacy and network behavior

• The plugin is local/offline by default for deterministic linking.
• The default built-in local model downloads model files from Hugging Face on first use, then runs on-device.
• When semantic mode uses Ollama, the plugin sends note-derived text to the configured Ollama endpoint, which is typically http://127.0.0.1:11434.
• Auto-maintenance can rebuild the note index and semantic cache after vault changes if you enable it in settings.
• No telemetry or analytics are included.
• No cloud service is required.

Commands

• Open control panel
• Analyze current note for safe links
• Auto-link current selection
• Analyze whole vault for safe links
• Show embedding explorer
• Build or rebuild semantic index
• Build or rebuild note index
• Show related notes

Development

Install dependencies:

npm install

Build:

npm run build

Lint:

npm run lint

Semantic regression tests:

npm run test:semantic

Dev vault sync:

npm run build:dev-vault

Manual install

Copy these files into:

<Vault>/.obsidian/plugins/semantic-auto-linker/

Files:

• main.js
• manifest.json
• styles.css

Then reload Obsidian and enable the plugin in Settings → Community plugins.

Known limitations

• Semantic suggestions are still more conservative and less reliable than deterministic title/alias matches.
• Semantic quality depends heavily on the local embedding model.
• The plugin is currently desktop-only.

Release

Marketplace release assets:

• main.js
• manifest.json
• styles.css

manifest.json and versions.json must be updated together for each release version.