qmd(Quick Markdown Search)是用于 Markdown 笔记、文档和知识库的本地搜索引擎,适合在多个 Markdown 文件之间检索、按主题或关键词查找文档,以及在关键词不足时进行语义搜索。
安装:bun install -g qmd。二进制安装到 ~/.bun/bin/qmd,必要时将路径加入 PATH:export PATH="$HOME/.bun/bin:$PATH" && qmd <command>。
建立索引:先创建集合,再更新索引,语义搜索需额外生成嵌入。 qmd init my-notes ~/notes qmd update -c my-notes qmd embed -c my-notes(可选,启用语义搜索)
搜索模式:默认使用 qmd search,基于 BM25 关键词匹配,速度很快。 qmd search "project ideas" -c my-notes 关键词不足时用语义搜索:qmd vsearch "what should I work on next" -c my-notes 资料建议避免 qmd query(混合加重排序),因其较慢且通常没有必要。
常用命令: qmd search "meeting notes" -c my-notes qmd search "birthday" -c contacts -n 10 qmd search "project" -c my-notes --json(JSON 输出,便于程序化使用) qmd vsearch "things I need to follow up on" -c my-notes qmd get "notes/2026-01-15.md" qmd multi-get "notes/2026-01-*.md"
索引维护:新增文件后运行 qmd update -c my-notes && qmd embed -c my-notes。
限制:若已知具体文件路径,直接读取即可,不必使用 qmd;qmd 的定位是在不知道答案位于哪个文件时跨文件搜索。其他功能、收费与平台信息暂未提供。