qmd

Search local Markdown collections using BM25 and optional embeddings.

5|Updated May 2, 2026
One-click install
npx skills add https://github.com/vanducng/skills --skill qmd-vanducng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/vanducng/skills/tree/main/skills/qmd
Command: npx skills add https://github.com/vanducng/skills --skill qmd-vanducng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local Markdown search with BM25 and optional vector embeddings for fast, on-device retrieval across personal notes, design-system catalogs, and knowledge bases.

Core Features & Use Cases

  • Local on-device indexing and search using BM25 by default for quick results.
  • Optional semantic search with embeddings and vector-based reranking when deeper relevance is needed.
  • Manage multiple Markdown collections, retrieve documents by path, docid, or glob, and refresh indices as your data changes.
  • Use cases include locating a specific design note, locating a past discussion in meeting transcripts, or pulling context for a current task.

Quick Start

Install qmd globally, create or point to a Markdown collection, and run a quick search to retrieve the top matching documents.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search local Markdown notes on-device without sending data to external services?

On-device Markdown search indexes local collections and retrieves relevant documents by path, docid, or glob. It operates locally without sending data to external services, ensuring privacy and fast retrieval.

How does BM25 search work for retrieving personal Markdown documents?

BM25 search ranks Markdown documents based on keyword relevance and term frequency. It is the default retrieval method for quickly locating specific design notes, meeting transcripts, or knowledge base entries.

Can I use semantic embeddings and vector search with my Markdown knowledge base?

Yes, you can enable optional semantic search with embeddings for your Markdown knowledge base. This provides vector-based reranking and LLM rerank capabilities when deeper relevance is needed beyond default BM25.

What's the best way to manage multiple Markdown collections and refresh indices as data changes?

The best way to manage multiple Markdown collections is to point to your directories and run indexing updates. This refreshes the indices as your data changes, keeping document retrieval accurate.

Does on-device Markdown search require an internet connection for optional embedding-based vsearch?

On-device Markdown search operates without sending data to external services. Optional embedding-based vsearch and LLM rerank are supported locally, ensuring retrieval works without relying on an external internet connection.

When should I not use default BM25 for searching local Markdown files?

You should not use default BM25 alone when you need deeper semantic relevance for local Markdown files. In such cases, switch to optional embedding-based vsearch and LLM rerank for better contextual retrieval.