0.2.2 — Pick a template on promotion

Changed

• Template folder instead of a single template file: promoting a mention now shows a picker listing every template in a configured folder (or none, via Esc), instead of always applying the same fixed template. Handy if you keep separate templates per type of note (person, place, project...).

Note

• This plugin does not run Templater syntax through Templater when applying a template — the template's text is used as-is with {{title}}/{{content}} substitution. See the README's "Templater note" under Commands for details. Real Templater integration is tracked as issue #14.

See CHANGELOG.md for full details.

Install

Download main.js, manifest.json, and styles.css below and copy them into <vault>/.obsidian/plugins/lightweight-mentions/, or add as a beta plugin via BRAT using this repo's URL.

0.2.1 — Real fix for mention-ranking noise, plus data-access transparency

0.2.0 was tagged before the word-boundary ranking fix landed, so it's shipping separately here.

Fixed

• The actual fix for the "unrelated results" bug: querying "test" was still surfacing titles like "Fatestrange Fake" because "test" is a coincidental mid-word substring of "Fatestrange" — the previous tiering counted that as a real match. Matching now requires the query to start an actual word in the title, not just appear as a substring anywhere. Fuzzy matches are also no longer mixed in alongside real matches — they only show up on their own when nothing real matched at all.

Documentation

• Added a "Data access" section to the README disclosing that the plugin reads every file name in the vault (plus stub file headings) to power the mention suggester — never file content, no network requests — per the Obsidian plugin review's recommendation.

See CHANGELOG.md for details.

Install

Download main.js, manifest.json, and styles.css below and copy them into <vault>/.obsidian/plugins/lightweight-mentions/, or add as a beta plugin via BRAT using this repo's URL.

0.2.0 — Better mention ranking, cleaner code

Fixed

• Mention suggester ranking on large vaults: on an 800-note vault, querying something like "Vivien" could surface a totally unrelated note ("Vivy - Fluorite Eye's Song") instead of what you meant, because Obsidian's fuzzy search matches by scattered subsequence and results were never scored or sorted. Matches are now ranked in tiers — exact match, then "starts with", then "contains" — with fuzzy matching only as a last-resort fallback. When nothing solid matches, "Create ..." is now shown first instead of buried at the end.
• Cleaned up the four issues flagged by the Obsidian plugin review bot: an unawaited promise, an unsafe any assignment, an EditorSuggest.selectSuggestion override with the wrong return type, and a dependency swap (builtin-modules → Node's own module.builtinModules).

Added

• A regression test suite (npm test) covering the ranking fix, proven to actually catch the bug (reverted the fix, confirmed the test failed with the exact reported symptom, then restored it).

See CHANGELOG.md for details.

Install

Download main.js, manifest.json, and styles.css below and copy them into <vault>/.obsidian/plugins/lightweight-mentions/, or add as a beta plugin via BRAT using this repo's URL.

0.1.0 — Lightweight mentions, minus the mention overhead

First release of Lightweight Mentions: a plugin for people who mention way more things than they actually want to turn into full notes.

What it does

• Type @ (configurable) followed by a name.
• Matches an existing note → links straight to it.
• Nothing matches yet → appends a heading to a shared stub file (Mentions.md by default) and links to that instead of forcing you to create a whole new note.
• Run Promote mention to full note whenever a stub deserves better: it extracts the heading into a real note (optionally through a template) and rewrites every existing link across the vault to point at the new note instead of the old heading.

Install

Download main.js, manifest.json, and styles.css below and copy them into <vault>/.obsidian/plugins/lightweight-mentions/. Or add it as a beta plugin via BRAT using this repo's URL.

See CHANGELOG.md for details.

Known limitations

• One global stub file — no per-topic/per-folder stub files yet.
• Heading matching for promotion is by exact text + heading level, so renaming a stub heading by hand before promoting can break the link rewrite.
• No alias support yet on file mentions.