Back to Skills

qmd

Search local markdown knowledge bases, notes, docs, and wikis with QMD. Use when users ask to find notes, retrieve documents, inspect a wiki, answer from indexed markdown, or set up QMD access.

25,166stars1,586forksUpdated 5/20/2026

Security Assessment

Safe(100/100)
Security Score100/100

About qmd

QMD is a local retrieval and search skill designed to help users query and explore markdown-based knowledge bases, including notes, documentation, wikis, transcripts, and other structured or unstructured text collections stored locally. It solves the problem of quickly finding relevant information within personal or project-specific markdown repositories, especially in situations where generic web search is unnecessary or less effective because the needed information already exists in a local indexed corpus.

The skill provides multiple search and retrieval capabilities through a command-line interface or MCP server integration. It supports collection discovery and system inspection via commands such as listing available collections and checking system status. QMD offers different search strategies, including fast lexical (BM25-style) search for exact terms, hybrid query search for semantic understanding and reranking, and structured queries that combine intent, lexical anchors, vector semantics, and hypothetical document generation signals. It also includes retrieval commands to fetch full documents or multiple documents, ensuring that responses can be grounded in actual source content rather than partial snippets. Additionally, MCP-based structured query execution enables programmatic multi-strategy search workflows.

QMD is intended for users who maintain large markdown knowledge bases and need efficient ways to retrieve information without manually browsing files. It is especially useful for developers, researchers, writers, and knowledge workers who rely on personal wikis, project documentation, or long-term note archives. It is also suitable for AI-assisted systems that require grounded retrieval before generating answers, helping ensure responses are based on real indexed content rather than hallucinated or external information.

FAQ

What is QMD used for?

QMD is used to search and retrieve information from local markdown knowledge bases such as notes, documentation, wikis, and transcripts.

What are the installation requirements for QMD?

QMD requires either the QMD CLI or MCP server and can be installed globally using npm with the package @tobilu/qmd.

What search methods does QMD support?

QMD supports lexical search (BM25-style), hybrid semantic query search, and structured queries that combine lexical, vector, and hypothetical document-based signals.

Can QMD work without local models or GPU support?

Yes, if local models or GPU acceleration are unavailable, QMD can fall back to lexical search instead of hybrid or semantic query modes.

Does QMD return full documents or only snippets?

QMD is designed to retrieve full documents using commands like get or multi-get to ensure responses are grounded in complete source content rather than snippets.

All Files

2 files
references/mcp-setup.md1.9 KB
View
SKILL.md6.3 KB
View

Install qmd

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

tobi/qmd