企业官网建设流程全解析

如何从零组织本地Markdown笔记库：ZenNotes的inbox、归档与回收站系统完整教程

【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes

ZenNotes 是一款键盘优先（Keyboard-first）的本地 Markdown 笔记应用：你的每一条笔记都是磁盘上的纯.md文件，配合 Vim 风格操作、inbox（收件箱）、archive（归档）与 trash（回收站）四大生命周期区域，让你从零开始就能快速组织起一个清晰、可恢复、不依赖任何私有数据库的本地 Markdown 笔记库。本教程将带你完整走通这套组织系统 🗂️

为什么"纯文件"是组织笔记库的最佳起点

很多笔记软件把内容锁进私有数据库，一旦离开应用，笔记就成了"数字囚徒"。ZenNotes 的设计选择恰恰相反：笔记库就是文件系统里的一个普通文件夹，Markdown 文件就是笔记本身（详见 docs/explanation/how-zennotes-works.md）。

这带来三个直接好处：

• 📄可迁移：换电脑、换软件，整个文件夹拷走即可
• 🔍可检查：任何编辑器、Git、ripgrep 都能直接读写你的笔记
• ♻️可恢复：删除只是"移动到 trash/"，归档只是"移动到 archive/"

官方参考文档 docs/reference/vault-and-folder-model.md 对这一模型做了完整说明：一个 ZenNotes vault（笔记库）= 一个普通目录，内容全部以文件和文件夹形式落盘。

四大生命周期区域：inbox、quick、archive、trash 全览

ZenNotes 内置了四个"生命周期区域"，它们不只是文件夹，而是产品级概念（对应虚拟标签页常量定义在 src/shared/archive.ts 与 src/shared/trash.ts）：

即使你自定义了侧边栏标签和图标，这四个区域的底层语义始终不变。新建的示例库会自带vault/inbox/Welcome.md，打开就能看到你笔记库的组织方式。

从零开始：五步搭建你的本地Markdown笔记库

第1步：打开笔记库，从 inbox 起步

首次打开 ZenNotes 时，选择一个文件夹作为笔记库（vault）——空文件夹从零开始，或选一个已有的 Markdown 文件夹直接导入。默认布局是"生命周期优先"：inbox/、quick/、archive/、trash/四区齐备（参考入门教程 docs/tutorials/get-started-desktop.md 的第 1、2 节）。

用侧边栏的+按钮、命令面板或快捷键新建笔记，它默认落在 inbox。注意一个关键行为：屏幕上的内容就是磁盘上的文件内容，没有隐藏数据库，外部程序改了文件，文件监听器也会同步更新界面。

第2步：用 quick 区域做"无压力捕获"

灵感来了先别纠结分类——ZenNotes 的 Quick Notes（快记）就存在quick/区域，本质仍是普通 Markdown 文件。在 Settings 中可配置：

• 命名方式：完整时间戳或仅日期
• 可选前缀：留空前缀会生成纯时间戳文件名

习惯上把"碎片先扔进 quick，周末再分拣进 inbox 或归档"，收件箱就不会变成杂物间。

第3步：归档（archive）清理活跃区

当一篇笔记"还在乎，但暂时不写"，把它移入 archive。归档视图的实现见 packages/app-core/src/components/ArchiveView.tsx：

• 所有archive/下的笔记按更新时间倒序集中展示
• 支持按标题、路径、摘要片段过滤
• 每行提供 Open / Unarchive（移回 inbox）/ Trash 三个操作
• 右键菜单还有重命名、移动、复制 Wikilink、在文件管理器中定位等

归档的核心价值：把"完成/休眠"的内容移出活跃循环，但不删除。

第4步：trash 回收站——可恢复的软删除

删除笔记不会立刻消失，而是先进trash/。回收站视图（packages/app-core/src/components/TrashView.tsx）提供：

• ♻️Restore：恢复被删笔记回原位
• 🗑️Delete：对单篇永久删除
• Empty Trash：一键清空整个回收站（二次确认，不可撤销）

还有一个容易忽略的细节：被删除的附件/图片资产也会单独保留在回收站底部的 "Deleted assets" 区块（落盘于.zennotes/deleted-assets），同样支持恢复或永久删除——图片不会"删了笔记就永远丢了"。

所有生命周期操作（archive / trash / restore / delete）都走统一的守卫式入口runNoteLifecycleAction，定义在 packages/app-core/src/lib/note-lifecycle-actions.ts，失败时会弹出友好的错误提示而不是静默出错。

第5步：导入 Obsidian 风格旧库？切换到 Vault root 模式

如果你的笔记库是扁平结构（顶层就是一个个文件夹，比如从 Obsidian 导入），在Settings → Vault中把Primary notes location从Inbox改为Vault root：

• 侧边栏直接展示顶层 Markdown 文件和文件夹
• 原本困在inbox/下的子文件夹可从侧边栏动作上移到库根
• 归档、回收站、快记等生命周期语义完全保留，只是主笔记区不再强制用 inbox

这是"有观点的默认 + 可自由呈现"的典型设计：默认教你一套好方法，也允许你按自己的结构来。

键盘优先：用 Vim 动作批量整理笔记库

ZenNotes 是 Keyboard-first 的，整理笔记库几乎可以全程不碰鼠标：

• j / k：在归档、回收站列表中上下移动光标
• gg / G：跳到列表顶部 / 底部
• Enter：打开当前笔记
• d：删除当前项（在归档中=移入回收站，在回收站中=永久删除）
• /：聚焦过滤框，快速筛选
• 多选：Cmd/Ctrl-点击逐项切换、Shift-点击选区，可批量打开、移动、归档/反归档、移入回收站

批量操作与 Vim 动作的结合，让"周五下午整理一次笔记库"变成几分钟的事。

常见问题速答

Q: 归档和删除有什么区别？归档 = 移出活跃区但保留（archive/）；删除 = 先软删除进 trash/，还可以恢复；只有"清空回收站"或手动 Delete 才是永久删除。

Q: 笔记会存进数据库吗？不会。全部内容都是 vault 文件夹里的纯 Markdown 文件，.zennotes/下仅存放少量 UI 行为元数据，不承载笔记内容。

Q: 归档和回收站能改名、换图标吗？可以。系统文件夹标签、图标、在侧边栏中的位置都支持自定义，底层archive/、trash/目录语义保持不变。

小结

从零组织本地 Markdown 笔记库，ZenNotes 给出的答案是一套完整的生命周期工作流：inbox 承接活跃写作，quick 负责无压力捕获，archive 沉淀休眠内容，trash 提供可恢复的安全删除，全程纯文件、可迁移、键盘优先。配合 Vim 动作与批量操作，一个数百篇笔记的库也能保持长期整洁 📚

延伸阅读：Vault and Folder Model · Get Started on Desktop · How ZenNotes Works

【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes