local-markdown-search

Index and search local Markdown collections with BM25 and vector embeddings.

2|1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/cdeistopened/skill-stack-skills --skill local-markdown-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-markdown-search
Source: https://github.com/cdeistopened/skill-stack-skills/tree/main/research-scraping/local-markdown-search
Command: npx skills add https://github.com/cdeistopened/skill-stack-skills --skill local-markdown-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local Markdown Search enables fast, private indexing and retrieval across your own Markdown collections using on-device tools like QMD. It supports full-text search via BM25, vector semantic search, and LLM-based re-ranking to surface precise passages without sending data to the cloud.

Core Features & Use Cases

  • Index markdown files into searchable collections for quick retrieval
  • Perform keyword, semantic, or combined searches across transcripts, notes, wikis, and documentation
  • Retrieve full documents or relevant snippets with source citations for research or knowledge management
  • Use in private, on-device workflows to protect sensitive information

Quick Start

Index Markdown files into a named collection with qmd collection add /path/to/folder --name my-markdown --mask '**/*.md' and then search with qmd search 'query'.

Frequently Asked Questions about local-markdown-search

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

FAQPage Schema
How do I search local Markdown files privately without sending data to the cloud?

On-device Markdown search indexes local files privately using BM25 full-text search, vector embeddings, and LLM-based re-ranking to retrieve precise passages without cloud data transmission.

What is the best way to combine keyword and semantic search across my Markdown notes?

Combine keyword and semantic search by indexing Markdown files into QMD collections, then querying with both BM25 full-text matching and vector embeddings to surface relevant snippets with source citations.

Can I use QMD to index and search Markdown documentation collections?

Yes, QMD can index Markdown documentation into named collections using a file mask, enabling fast retrieval of relevant snippets or full documents for research and knowledge management workflows.

Do I need the Bun runtime to perform on-device Markdown indexing and retrieval?

Yes, on-device Markdown indexing via QMD collections and embedding generation requires the Bun runtime and QMD tooling to execute local full-text and semantic searches.

How do I retrieve exact passages with source citations from local Markdown wikis?

Retrieve cited passages by indexing Markdown wikis into a QMD collection, then searching with queries that apply BM25 and vector re-ranking to return precise snippets with source references.

Are there limitations when using on-device full-text search for large Markdown collections?

On-device full-text search keeps data local but requires sufficient hardware resources for embedding generation and re-ranking, and depends on the Bun runtime and QMD tooling for indexing operations.