qmd

Index and search local Markdown collections with BM25, semantic, or hybrid search.

Updated Mar 28, 2026

Search Tags:#markdown #embeddings #search #semantic #local #bm25 #qmd

Ready to run

npx skills add https://github.com/sandalsoft/agent-skills --skill qmd-sandalsoft

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/sandalsoft/agent-skills/tree/main/qmd
Command: npx skills add https://github.com/sandalsoft/agent-skills --skill qmd-sandalsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locally stored notes, docs, and knowledge bases can become hard to locate; this skill indexes Markdown collections and enables fast, accurate search.

Core Features & Use Cases

Index Markdown collections once and search with BM25 for fast results, semantic similarity for related content, or hybrid search for best quality.
Apply to notes, docs, journals, wikis, and knowledge bases; useful when you need to retrieve specific mentions or related concepts.
Quick Start example: index a folder of Markdown files and run a search to retrieve relevant documents.

Quick Start

Index your Markdown notes by creating a collection and running the initial index and embedding to enable fast searching.

Frequently Asked Questions about qmd

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

FAQPage Schema

How do I search my local Markdown notes and knowledge base?▼

You can index your local Markdown collections and run queries using BM25 for fast results, semantic similarity for related content, or hybrid search for best quality.

What is the difference between BM25 and semantic search for Markdown files?▼

BM25 finds exact keyword mentions in Markdown files, while semantic search uses embeddings to locate related concepts; hybrid search combines both to yield the highest quality matches.

How do I index a folder of Markdown files for fast retrieval?▼

Create a collection for your Markdown files and run the initial indexing and embedding process to enable fast local searching across your notes.

Can I periodically update the search index for my project notes?▼

Yes, the skill supports periodic updates to the index, allowing you to keep your project notes, journals, and wikis current without needing a full one-time re-indexing every time.

Do I need external dependencies to run local Markdown semantic search?▼

No external dependencies are required, as the skill operates independently to index collections and generate embeddings on your machine.