ZenNotes：键盘优先的本地 Markdown 笔记

项目简介

ZenNotes 是一款键盘优先的 Markdown 笔记应用，笔记以普通 .md 文件保存在你选定的 vault 目录中，不会写进隐藏数据库。它以 Electron 桌面应用为主要形态，同时提供一个由 Go 服务端支撑的自托管 Web 版本，并计划在同一套 Web/服务端栈上推出托管部署模式。项目用 TypeScript 编写，采用 MIT 许可证。

主要功能

• 纯文件优先：每条笔记就是 vault 里一个普通 .md 文件，可直接被其他工具读写。
• 键盘优先：完整的 Vim 模式、leader 键流程、命令面板、窗格与标签跳转、本地 ex 命令、内置帮助，打开即用。
• 编辑 / 预览 / 分屏：三种工作模式随时切换，支持固定参考窗格；桌面端还支持浮动笔记窗口。
• 渲染能力：GitHub 风格 Markdown、KaTeX 数学公式、Mermaid、TikZ、JSXGraph、function-plot、callouts、脚注、wiki 链接与反链。
• 组织与检索：任务、标签、归档、回收站、快速笔记视图；支持按标题和路径搜索、全库文本搜索。全文搜索可使用内置引擎、ripgrep 或 fzf，自动检测，也可自定义二进制路径。
• 日记与周记：可选开启，目录和标题支持 yyyy/MM-MMM、yyyy-MM-dd-EEE、ISO 周 yyyy-'W'ww 等模式，月份和星期名可按 BCP 47 locale 本地化。
• CSV 数据库：在普通 .csv 文件之上提供 Notion 风格的 Table 和 Board 视图。
• MCP 集成：自带 MCP server，让支持 MCP 的工具直接操作同一个 vault，而不是副本。
• zen CLI：桌面端可从设置里安装命令行伴侣，用于列出、读取、搜索、捕获、编辑、归档/删除笔记，以及任务、文件夹和 MCP 相关操作；macOS 上还能本地安装 Raycast 扩展，通过 zennotes:// 深链搜索、打开、归档笔记。
• Obsidian 风格 vault 兼容：主笔记区可以直接是 vault 根目录，![[image.png]] 形式的嵌入能正常解析，并识别旧的 attachements/、_assets/ 目录。
• 本地文件：图片、SVG、视频、音频、PDF 等可在标签页或参考窗格中直接打开，右键可在文件管理器中显示。
• 自定义：主题族与明暗模式、界面/正文/等宽字体、字号行高、内容宽度与对齐、键位覆盖、Vim 开关等。

安装与使用

桌面安装包都附在 GitHub Releases 页面，应用支持自动更新，下载一次即可。

macOS（推荐 Homebrew）：

brew install --cask zennotes/tap/zennotes

也可以下载对应芯片的 .dmg，打开后把 ZenNotes 拖进「应用程序」；构建已签名并公证。

Windows：下载 ZenNotes-<version>-win-x64.exe（Intel/AMD）或 ZenNotes-<version>-win-arm64.exe（ARM）安装运行。

Linux：

yay -S zennotes-bin

此外还提供 .pacman 包、.deb 包、Nix 打包说明和 AppImage。

安装完成后选择一个 vault 目录即可开始写笔记；zen CLI 可在「设置 → CLI」中安装。自托管 Web 版本需要自行运行 Web 客户端和 Go 服务端，具体见仓库文档。

注意事项

• 桌面端与 Web 端共享同一套核心界面，但功能并不完全一致。原生菜单、自动更新、浮动笔记窗口、zen CLI 安装、macOS 本地 Raycast 扩展安装、MCP 安装流程、在文件管理器中显示等仅桌面端提供。
• 自托管 Web 模式包含 Go 后端、文件监听、服务端 vault 选择器和局域网/家用服务器访问。
• 使用 AppImage 需要 FUSE 2。只提供 FUSE 3 的发行版（如 Arch、CachyOS、Fedora）可安装 fuse2，或加 --appimage-extract-and-run 运行，也可以直接用 AUR / .pacman / .deb 包。
• 项目在开发过程中大量借助 AI 工具辅助编码。

本作品整理自 GitHub 开源项目 ZenNotes/zennotes，原作者 @ZenNotes，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。