半小时收编几百个散落的 .md:这个 18MB 的小工具,把本地笔记变成了能搜的知识库

原创2026-11-05 20:15:221,955 阅读

半小时收编几百个散落的 .md:这个 18MB 的小工具,把本地笔记变成了能搜的知识库

你有没有过这种时刻:电脑里躺着三五个文件夹,全是这几年攒下的 Markdown 笔记——读书摘抄在一个盘,工作方案在另一个盘,微信里存下来的教程又是一堆。想找一句话,只能一个文件一个文件点开,Ctrl+F 按到手指发酸。

网盘笔记倒是能搜,可你的东西一旦上传,就变成了别人服务器上的一行数据;用 Obsidian 那类工具吧,功能是真强,但光是插件、仓库、同步方案就够折腾一晚上。

最近我在 GitHub 上翻到一个挺对胃口的新项目,叫 quiet.md。它的定位特别朴素:一个又快又安静的本地笔记应用。没有账号、不联网、默认不云同步,笔记就是你电脑上一个普普通通的文件夹。

我花了大概半小时,把散在各处的 .md 全收了进去。下面把这套流程原样交给你,包括几个容易踩的坑。

一、它到底是个啥?一句话:把文件夹变成"图书馆"

你可以把它理解成给一堆散装文件配了个图书管理员。

你电脑里那些 .md,本来只是"文件名 + 一堆文字"。quiet.md 做的是:给每篇笔记配一个标题、一个目录位置、一份可搜索的正文索引,然后摆成一个左侧目录树 + 右侧网格的书架。

主界面:左侧文档树,右侧网格排列所有笔记

和印象笔记、Notion 最大的不同有两点。

第一,它不搬家。你的笔记本来在哪个文件夹,导入后依然是你电脑上的文件,只是换了一份更好看的"书架"。哪天不想用了,文件还在原地,拿记事本也能打开。

第二,它真的快。整个界面是 Rust 语言直接调显卡画出来的,不是套一层浏览器内核的网页壳。官方给的数据是:在一篇 100 万字、549 章的巨型文档里连续打字、退格、滚动,每一帧的处理时间 P95 都在 6 毫秒以内。换算成人话——120Hz 的高刷屏,每帧只有 8.3 毫秒的预算,它还剩着余量。

安装包也很克制:macOS 版约 18MB,Windows 版约 14MB。对比一下动辄几百兆的"现代笔记软件",这个体积本身就很说明问题。

二、上手全流程:半小时,四步走完

第一步,下载安装。 官网和 GitHub 都有现成的安装包,macOS(需 Apple Silicon,系统 13 以上)和 Windows(10 的 2004 版本以上)都能用。Mac 版已经过了苹果签名和公证,拖进"应用程序"就行;Windows 首次运行可能弹 SmartScreen,点"更多信息 → 仍要运行"。

这里插一句实话:Intel 芯片的老 Mac 暂时没有现成安装包,得自己编译。如果你用的是几年前的 Intel MacBook,这一步会劝退,提前有个心理准备。

第二步,认一下你的"书库"在哪。 第一次打开,它会在你的"文稿"文件夹里建一个 Quiet.md 文件夹,里面装着所有笔记、图片附件和一份索引。这个文件夹就是你的全部家当——想备份,压缩一下拷走;想同步,扔进 iCloud、坚果云、OneDrive 都行;想上 Git 做版本管理,也完全可以。

顺便说,新库第一次启动会自带一套"开始指南",十几篇,把快捷键、表格、代码块、导入导出都过了一遍,而且这些指南本身就是用它自己写的。想练手,直接在里面改就行。

第三步,批量导入。 主页上有个"上传"卡片,也可以按快捷键调出导入,一次能选多个文件。它吃两种格式:Markdown(.md / .markdown / .txt)和飞书文档导出的小众格式 DocxXML。

选完文件,几百篇一次性进来,每篇自动成为一页。文件名就是标题;如果正文第一行的一级标题和文件名一模一样,它会聪明地去掉重复的那行,不会出现"标题写两遍"的尴尬。

第四步,开始搜。 按下搜索快捷键,一个干净的搜索框弹出来,输入关键词,结果会按"标题命中优先、正文命中在后"的顺序排好,每条下面带两行高亮摘要。上下键选,回车打开,Esc 关掉,全程不用碰鼠标。

到这儿,半小时的预算其实还用不完。

三、目录和命名的三条"土规矩",能省你后面三小时

导入这步虽然一键完成,但它有个必须提前知道的特性:导入是"平铺"的,不会还原你原来的文件夹层级。

也就是说,你在电脑里按"工作 / 生活 / 学习"分好的三层目录,导进来之后全在顶层,得自己再整理。这不是 bug,是取舍——它把层级交给你在应用里手动建"子页面"。

所以在导入之前,我建议你花五分钟做三件事:

第一,文件名写成"人话"。 因为文件名直接变成标题,2023-11-05.md 这种标题在书架里就是灾难。改成"11月5日 客户沟通纪要",一眼就知道是什么。顺手把 /、: 这类符号去掉,它们会被替换掉。

第二,同名文件先合并。 我自己的笔记里就有三个 README.md、两个 笔记.md。导入后你会收获一堆同名文档,虽然系统不会覆盖,但你自己会疯。提前加个前缀,比如"项目A-笔记"。

第三,图片跟着文件走。 如果你在 .md 里用相对路径引用了本地图片,导入时它会顺着路径把图片复制进笔记库,链接自动改好。但如果图片早就被删了、或者路径写的是别人的电脑,那就只能看到一个破图。建议导入前先把图片和 md 放在同一个文件夹里。

至于整理,进来之后你可以给每篇笔记建子页面、置顶、收藏、打标签式的分组,还能框选最多 50 篇做批量移动、复制、删除。这一步不着急,先让搜索能跑起来,目录慢慢理。

四、三个抽查用例,验证它到底"搜不搜得到"

导入完最怕什么?怕的是"看起来进去了,其实搜不到"。我习惯用三个用例做体检,你也可以照着抄。

用例一:搜标题。 随便挑一篇你确定存在的笔记,输入它标题里的两个字。预期结果是它排在最前面——因为它的排序逻辑就是标题优先。如果标题搜不到,说明这篇压根没导进来。

用例二:搜正文里的一句话。 挑一句你记得、但不在标题里的短语,比如"这个方案下周三之前要给到客户"。预期是这一篇出现在结果里,并且下面那两行摘要正好把这句话高亮出来。这一步验证的是正文索引有没有建好。

用例三:搜一个中文词 + 一个错别字,看看它的边界。 这一步是"压力测试",也是我给你打的预防针:它用的是老老实实的"包含匹配",没有分词、没有模糊纠错、没有同义词联想。

所以你搜"周报"能命中"本周周报模板",但你搜"报告"不会命中"周报";你打错一个字,它就真的找不到。这一点和那些动不动就上向量检索的 AI 笔记工具不一样——好处是快、可预测、不会给你一堆"看起来相关其实无关"的结果,坏处是你得记得准。

知道了这个脾气,你的用法就会变:关键词尽量用你原文里真实出现的词,别用自己脑补的近义词。这是最实在的一条经验。

五、还有几个我觉得挺妙的细节

它认飞书的格式。 这一条对国内办公党来说是隐藏福利。它存笔记用的就是飞书文档的那套 XML 格式,从飞书里复制一大段带高亮块、分栏、表格的内容粘过来,结构基本能保住;反过来导出、粘贴回去也不至于全乱。经常在飞书里写文档、又想留一份本地底稿的人,会懂这个价值。

导出去也不锁死。 一篇笔记可以导出成 PDF(A4 排版,样式、图片、表格都在),也可以导出成 Markdown,还能选"仅文本"或"连图片附件一起打包"。写公众号、交周报、发给同事,都够用。

主题能自己改。 内置了 Craft、飞书、Notion、Obsidian 四套风格,深色浅色都能跟系统走。还允许你自己写 CSS 调样式——这条对爱折腾的人是加分项,对不想折腾的人完全可以直接无视。

关掉窗口不会丢东西。 每次改动 500 毫秒后自动落盘,写盘失败不会假装成功,顶栏会亮错误提示;所有文件都是"先写临时文件再替换",就算写到一半断电,磁盘上要么是旧版本、要么是新版本,不会出现半截文件。

六、说点不吹的话:它适合谁,不适合谁

它不是万能的。目前还是 Beta 版本,在快速迭代;没有手机端;没有多人协作;没有云同步(得你自己接网盘或 Git);搜索是字面匹配,不带 AI 那套语义理解;导入不还原文件夹层级。

所以我的判断很直接:

  • 如果你是写作者、自媒体、程序员、学生,手上有一堆 .md 或者飞书文档,想要一个打开就能写、关掉就存本地、搜索秒出的地方——它非常对味。
  • 如果你需要手机随时看、团队一起改、AI 自动总结——它现在还满足不了你,等等看或者另找工具。

但如果你只是想让那堆散落在硬盘角落的笔记"活过来",能被搜到、能被翻到、不用把隐私交给任何一家公司,那这半小时花得值。

最后留个问题给你:你电脑里最老的一份笔记,是哪一年写的? 我翻自己的库,翻出了 2016 年的一条待办——"整理一下笔记"。这条待办,我今天才算真正完成。

登录后查看全文
quiet-md