qmd

Locate and retrieve Markdown notes from indexed collections using hybrid search.

278|26|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ninehills/skills --skill qmd-ninehills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/ninehills/skills/tree/main/skills/qmd-skill
Command: npx skills add https://github.com/ninehills/skills --skill qmd-ninehills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locates and retrieves relevant Markdown notes and documents from indexed collections using a hybrid local search, reducing time spent scanning scattered folders.

Core Features & Use Cases

  • Local hybrid search for Markdown notes and docs (BM25 by default with optional semantic search)
  • Indexed collections enable fast discovery of related content and retrieval of specific documents
  • Use cases include finding related notes, cross-referencing information, and extracting documents from knowledge bases

Quick Start

Install qmd, index your notes, and start searching with a simple query.

Frequently Asked Questions about qmd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search across local Markdown notes and knowledge bases?

You can search local Markdown notes by indexing your folders and running a query to retrieve relevant documents. This local hybrid search uses BM25 by default to locate specific files and cross-reference information across your knowledge base.

How does local hybrid search for Markdown documents work?

Local hybrid search works by indexing Markdown files and applying BM25 text matching to retrieve relevant documents. It optionally combines vector-based similarity search to improve semantic discovery of related content across your local folders.

Do I need a specific runtime to index Markdown notes locally?

Yes, indexing Markdown notes requires a local qmd binary and a Bun-based installation. You need this specific environment setup to build indexed collections and run fast queries against your personal knowledge base.

Can I use semantic search instead of BM25 for my Markdown project notes?

Yes, you can use optional vector-based similarity search alongside the default BM25 algorithm. This enables semantic search to find related content and retrieve specific documents from your project notes more effectively.

What is the best way to retrieve specific documents from scattered Markdown folders?

The best way to retrieve specific documents is to index your scattered Markdown folders into local collections. Once indexed, you can quickly locate and extract relevant notes using hybrid search instead of manually scanning directories.