qmd

Search markdown files using QMD CLI or MCP server with lex, vec, and hyde queries.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/eykd/vance-ts --skill qmd-eykd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/eykd/vance-ts/tree/main/.agents/skills/qmd
Command: npx skills add https://github.com/eykd/vance-ts --skill qmd-eykd

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the process of searching through markdown knowledge bases, notes, and documentation, making it easy to find relevant information quickly.

Core Features & Use Cases

  • Markdown Knowledge Base Search: Quick and efficient search of markdown files.
  • Query Types: Supports lex (exact terms), vec (semantic), and hyde (hypothetical document) query types.
  • Collections: Search across multiple collections of markdown files.
  • CLI and HTTP API: Provides a command-line interface and HTTP API for easy integration.
  • Use Case: Use this Skill when you need to search for specific information within your markdown files, such as documentation or notes.

Quick Start

Search for markdown content using the qmd skill with your query, e.g., qmd query "CAP theorem consistency".

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search through markdown documentation for specific terms?

To search markdown documentation, you can use the qmd CLI or MCP server to query your knowledge base. It supports exact term matching (lex), semantic search (vec), and hypothetical document queries (hyde) to find specific information.

What's the best way to perform a semantic search across markdown notes?

The best way to perform a semantic search across markdown notes is using the vec query type provided. This approach allows you to find conceptually relevant information within your markdown collections rather than relying solely on exact keyword matches.

Does markdown knowledge base search require any specific environment setup?

Markdown knowledge base search requires the qmd CLI or the MCP server to be installed and running. Once the environment is set up, you can execute queries directly via the command line or integrate the search into your applications using the HTTP API.

Can I integrate markdown search into my existing scripts and applications?

You can integrate markdown search into scripts and applications by utilizing the provided HTTP API or the command-line interface. This allows you to programmatically query your markdown collections and retrieve relevant documentation automatically.

When should I use different query types to search markdown files?

Use lex for exact term matching, vec for semantic relevance, and hyde for hypothetical document queries when searching markdown files. Choosing the right query type ensures you efficiently extract the specific information needed from your documentation.

How do I search multiple collections of markdown files at once?

You can search multiple collections of markdown files at once by executing a query through the qmd CLI or HTTP API. This allows you to simultaneously retrieve relevant information across different groups of markdown documentation or notes.