文章总结： qmd是一款基于TypeScript开发的开源本地文档搜索工具，GitHub近3万星，支持全本地运行、全格式兼容和语义级搜索，解决本地文件检索效率低的问题。安装使用简单，三步即可上手，适合开发者、职场办公族和知识库用户使用。 综合评分： 75 文章分类： 产品介绍

本地文档搜索神器qmd

原创

爱写程序的小子 爱写程序的小子

牛马的一天开始

2026年9月15日 07:20 福建

在小说阅读器读本章

去阅读

在公众号小说中沉浸阅读

本地文档搜索神器qmd

你有没有过这种经历？攒了几个G的技术文档、会议纪要、项目方案存在本地，急着找某段内容时，翻了十几层文件夹都找不到，系统自带搜索慢半拍还搜不准，用在线工具又怕公司敏感内容泄露。今天要推荐的GitHub近3万星开源工具qmd，刚好能完美解决这个痛点。

🎯 解决了什么痛点

不管是程序员存储的代码片段、技术文档，还是职场人整理的会议记录、项目素材，散落在本地不同格式、不同文件夹里时，检索效率极低。现有桌面搜索工具要么广告多、体积臃肿，要么只支持关键词匹配，记不清准确表述就找不到内容，云端工具还存在数据泄露风险。qmd是一款全本地运行的迷你命令行搜索引擎，在保证数据安全的前提下，帮你毫秒级定位所有本地文档内容。

⚡ 核心功能与技术亮点

qmd基于TypeScript开发，安装包不到10M，内存占用低于100M，低配设备也能流畅运行，核心亮点有三个：

• 全本地安全运行：集成SOTA开源语义检索模型，所有计算本地完成，无需联网，涉密内容可放心检索。

• 全格式兼容：支持Markdown、PDF、Word、纯文本、常见代码文件，笔记、会议稿、代码均可统一检索。

• 语义级搜索：不局限于精确关键词，记得内容大意即可匹配，响应速度稳定在毫秒级。

📌 场景与优势对比

日常使用中，qmd覆盖全场景本地检索需求：程序员可快速定位代码片段、技术方案，无需在IDE和文件夹间反复切换；职场人可快速查找历史会议决策、旧方案参考数据，不用翻遍存储目录；知识库用户可将所有笔记目录加入索引，实现跨软件全局检索。

和同类工具比，qmd无广告无冗余功能，比商业桌面搜索轻量80%以上；比笔记软件内置搜索通用性强，不绑定特定应用；比云端工具更安全，全程无数据上传。

🛠️ 快速上手指南

qmd使用门槛极低，哪怕很少接触命令行的用户，跟着三步就能用： 1. 安装：各系统用户可直接从GitHub发布页下载对应二进制包，也可用npm一键安装：

`npm install -g @tobi/qmd

2. 构建索引：打开终端进入目标文件夹，执行索引命令，首次索引几千个文件仅需几十秒：

qmd index

3. 开始搜索：输入搜索指令，支持模糊语义描述，快速返回匹配结果：

“qmd “Q3项目预算调整记录”“`

👥 适用人群与建议

qmd适合所有高频处理本地文件的用户：开发者、职场办公族、本地知识库重度用户，都能靠它大幅节省找文件的时间。

它的上手难度仅为两星，只需掌握3个基础命令即可流畅使用，无需复杂配置。建议首次使用先从常用工作文件夹建索引，后续再逐步添加其他目录，避免首次扫描全硬盘耗时过长。

🔗 项目地址：https://github.com/tobi/qmd

你平时有什么快速检索本地文件的小技巧？欢迎在评论区分享交流~

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：牛马的一天开始 爱写程序的小子 爱写程序的小子《本地文档搜索神器qmd》