qmd — Fast Local Markdown Search
When to Use
- - Finding files — use instead of
find across large directories (avoids hangs) - Searching notes/docs — semantic or keyword search in indexed collections
- Code discovery — find implementations, configs, or patterns
- Context gathering — pull relevant snippets before answering questions
Quick Reference
Search (most common)
CODEBLOCK0
Collections
CODEBLOCK1
Get Files
CODEBLOCK2
Output Formats
- -
--files — paths + scores (for file discovery) - INLINECODE2 — structured with snippets
- INLINECODE3 — markdown formatted
- INLINECODE4 — limit results
Tips
- 1. Always use collections (
-c name) to scope searches - Run
qmd update after adding new files - Use
qmd embed to enable vector search (one-time, takes a few minutes) - Prefer
qmd search --files over find for large directories
Models (auto-downloaded)
- - Embedding: embeddinggemma-300M
- Reranking: qwen3-reranker-0.6b
- Generation: Qwen3-0.6B
All run locally — no API keys needed.
qmd — 快速本地 Markdown 搜索
使用场景
- - 查找文件 — 替代 find 命令遍历大型目录（避免卡死）
- 搜索笔记/文档 — 在索引集合中进行语义或关键词搜索
- 代码发现 — 查找实现、配置或模式
- 上下文收集 — 在回答问题前提取相关片段
快速参考
搜索（最常用）
bash
关键词搜索（BM25）
qmd search alpaca API -c projects
语义搜索（理解含义）
qmd vsearch 如何实现止损
结合重排序的混合搜索（最佳质量）
qmd query 突破交易规则
仅返回文件路径（快速发现）
qmd search config --files -c kell
返回完整文档内容
qmd search 模式检测 --full --line-numbers
集合管理
bash
列出所有集合
qmd collection list
添加新集合
qmd collection add /path/to/folder --name myproject --mask
.md,.py
变更后重新索引
qmd update
获取文件
bash
获取完整文件
qmd get myproject/README.md
获取指定行
qmd get myproject/config.py:50 -l 30
使用通配符获取多个文件
qmd multi-get *.yaml -l 50 --max-bytes 10240
输出格式
- - --files — 路径 + 分数（用于文件发现）
- --json — 结构化输出，包含片段
- --md — Markdown 格式
- -n 10 — 限制结果数量
提示
- 1. 始终使用集合（-c name）来限定搜索范围
- 添加新文件后运行 qmd update
- 使用 qmd embed 启用向量搜索（一次性操作，耗时数分钟）
- 大型目录优先使用 qmd search --files 而非 find 命令
模型（自动下载）
- - 嵌入模型：embeddinggemma-300M
- 重排序模型：qwen3-reranker-0.6b
- 生成模型：Qwen3-0.6B
全部本地运行 — 无需 API 密钥。
