QMD Search for Desktop
pendingby Rajavanya Subramaniyan
Search your vault using QMD. Requires qmd CLI installed.
QMD Desktop-only Search for Obsidian
An Obsidian plugin that integrates QMD local search (BM25 full-text search, vector semantic search, and LLM re-ranking) into a native-feeling search modal.
Prerequisites
- QMD installed via
bun install -g https://github.com/tobi/qmd - A QMD collection named
obsidianpointing to your vault:qmd collection add /path/to/your/vault --name obsidian qmd embed - Embeddings generated (run
qmd embedafter indexing)
Install (manual)
# Clone or copy this folder into your vault's plugins directory
cp -r obsidian-qmd-search /path/to/vault/.obsidian/plugins/qmd-search
# Build
cd /path/to/vault/.obsidian/plugins/qmd-search
npm install
npm run build
# Enable the plugin in Obsidian Settings > Community Plugins
Usage
- Open the command palette (Cmd/Ctrl + P)
- Search for "QMD" and choose from one of the three search mode commands
- Type your query and press Enter
- Wait for results (hybrid search uses LLM reranking, may take a few seconds)
- Click a result or use arrow keys + Enter to open the file
Settings
- QMD binary path: defaults to
qmd. If Obsidian can't find it, set the full path (e.g./Users/you/.bun/bin/qmd) - Collection name: defaults to
obsidian - Max results: defaults to 16
Notes
- This plugin is desktop-only (it uses
child_processto call the qmd CLI) - The
qmd querycommand uses hybrid search with LLM reranking, which gives the best quality results but is slower than plainqmd search. First run may be slow if models need to load. - Keep your index fresh with
qmd updateandqmd embedperiodically
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.