Alias Quick Switcher

You gave a note an alias so you could find it by the name you actually call it, and you gave its folder one too. Obsidian's quick switcher honours neither the moment you type a path: Echo finds the note, but Alpha/Delta/Echo finds nothing, because the built-in matches your query against the path or against an alias and never against a mixture of the two. This plugin matches segment by segment, where each segment may be satisfied by a real name or by an alias — the note's own, or the alias on a folder's folder note.

More screenshots

Demo vault

The documentation is a demo vault. Every feature has a note that explains what it does, with a worked example you can search yourself.

Start reading here — it is plain markdown, so it works on GitHub with nothing installed.

A copy of the vault ships with every release. You can access it via any of the following:

1. Running the Alias Quick Switcher: Open demo vault command.
2. Downloading alias-quick-switcher-demo-vault.zip from the Releases. It unzips into a single alias-quick-switcher-demo-vault-<version> folder.
3. Browsing its source in demo-vault/ in this repository.

What it does

Take Alpha/Bravo/Charlie.md, where Charlie is aliased Echo and the Bravo folder's folder note is aliased Delta. Obsidian's own switcher finds it from the first four queries and from none of the last three:

Query	Built-in	This plugin
Alpha/Bravo/Charlie	✅	✅
Alpha Bravo Charlie	✅	✅
Bravo Charlie	✅	✅
Echo	✅	✅
Alpha/Bravo/Echo	❌	✅
Alpha/Delta/Charlie	❌	✅
Alpha/Delta/Echo	❌	✅

Folder aliases are the half nothing else does. A folder has no frontmatter, so its alias lives on its folder note — and no switcher consults it. That matters most in the vaults where it is most needed: if your folder notes all share one name, the built-in cannot reach any of them by name at all, and their aliases are the only handle you have.

It reads your existing folder-note setup rather than inventing another one. If the Folder notes plugin is installed, its live configuration decides which note belongs to a folder — including a custom name and whether the note sits inside the folder or beside it. Nothing is copied into this plugin's settings, so reconfiguring that plugin needs no migration here.

Every row tells you why it matched, in the switcher's own visual language. A hit reached through a folder alias is rendered as what you typed — Alpha/Delta/Echo — with the real path, Alpha/Bravo/Charlie, underneath it and the same alias marker Obsidian already puts on an alias hit. A row matched by real names alone shows one line, because there is nothing to explain. And a plain alias on the note itself looks exactly as it does in the built-in switcher, because it is the same row — this plugin extends that shape to the rest of the path rather than inventing a second one to learn.

Real names outrank aliases. A result matched entirely by real names ranks above one that needed an alias, so the plugin never reorders the matches you already get today. That is the default ranking; the other one treats an alias as just another name and orders purely by how well the query matched, which surfaces alias hits sooner and gives that guarantee up. Both are a setting, as is whether a segment has to match as one unbroken run or only as characters in order.

Usage

Assign a hotkey to Alias Quick Switcher: Open quick switcher and type a path. Obsidian's own quick switcher and its Ctrl+O are left exactly as they are — this plugin patches nothing, so you decide which of the two your muscle memory opens.

Segments are separated by / or by spaces, and a partial path works: Delta/Echo is enough.

Installation

The plugin is not yet listed in the official Community Plugins repository. Until it is, install it as a beta release.

Beta versions

To install the latest beta release of this plugin (regardless if it is available in the official Community Plugins repository or not), follow these steps:

1. Ensure you have the BRAT plugin installed and enabled.
2. Click Install via BRAT.
3. An Obsidian pop-up window should appear. In the window, click the Add plugin button once and wait a few seconds for the plugin to install.

Debugging

By default, debug messages for this plugin are hidden.

To show them, run the following command in the DevTools Console:

window.DEBUG.enable('alias-quick-switcher');

For more details, refer to the documentation.

Changelog

All notable changes to this project will be documented in the CHANGELOG.

Contributing

Contributions are welcome — see CONTRIBUTING to get set up.

Support

My other Obsidian resources

See my other Obsidian resources.

License

© Michael Naumov