qmd

Index and query markdown files with lexical and vector search.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/woosul/wikey --skill qmd-woosul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/woosul/wikey/tree/main/tools/qmd/skills/qmd
Command: npx skills add https://github.com/woosul/wikey --skill qmd-woosul

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tobilu/qmd, and includes scripts (resource) and references (resource) components.

What problem does it solve?

qmd solves the problem of efficiently searching and retrieving information from markdown knowledge bases, notes, and documentation. It helps users find documents, look up information, and perform in-depth searches without manually scanning through files.

Core Features & Use Cases

  • Search Markdown Content: Search for specific information within markdown files using various query types (lex, vec, hyde).
  • Query Types: Lexical search using exact terms or phrases, vector search using natural language questions, and hypothetical document search using answer passages.
  • Collections Filtering: Filter searches to specific collections of markdown files.
  • MCP Server: Integrate with Markdown Content Providers (MCP) for a seamless search experience.

Quick Start

To search for the term "CAP theorem" in the "docs" collection, run: qmd query "CAP theorem consistency" --collections docs

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search for specific information across multiple markdown files?

Markdown search engines use lexical search for exact terms and vector search for natural language questions. This allows you to retrieve information from notes and documentation using either exact phrases or conceptual queries.

What is the best way to query a specific collection of markdown notes?

You can query a specific markdown collection by running a local CLI command with a collections flag. For example, use `qmd query "search terms" --collections docs` to filter results to the "docs" subset.

Does markdown search work with the Markdown Content Provider MCP protocol?

Yes, markdown search works with the Markdown Content Provider (MCP) protocol for server-side queries. This integration provides a seamless search experience for retrieving indexed markdown documents over a server connection.

Can I use hypothetical document search to retrieve markdown content?

Hypothetical document search (hyde) in markdown retrieval accepts answer passages as queries. This vector-based method matches the semantic meaning of the passage to find relevant information within indexed knowledge bases.

What are the limitations of using lexical search for markdown knowledge bases?

The limitation of lexical search for markdown knowledge bases is that it relies on matching exact terms or phrases. It may miss conceptually relevant documents if the exact vocabulary is not used, unlike vector-based search methods.