
以键盘为先的本地 Markdown 笔记,支持 Vim 运动、图表和 MCP 集成。
概览
ZenNotes 是一款以键盘为先的 Markdown 笔记应用,拥有共享的产品核心和多个运行时: - 一款使用 Electron 构建的桌面应用——由 Go 服务器支持的自托管网页应用——未来基于同一 Web/服务器栈构建的托管部署模式 ZenNotes将你的笔记保存为普通的Markdown文件。它增加了支持Vim的编辑、拆分和预览工作流程、任务、标签、归档/垃圾桶、图表、搜索、每日笔记、CSV数据库(类似Notion风格的表格+板块视图,基于普通.csv文件),以及在你已有文件基础上的MCP集成。在macOS上,第一方Zen CLI也支持启动器工作流,比如Raycast扩展。 从GitHub Releases获取最新版本——见下方“安装”。网站:zennotes.org 支持开发:GitHub Sponsors 详细的仓库内文档存放在docs/README.md下。 所有桌面安装程序都绑定在每个 GitHub 版本中。应用会自动更新,所以你只需下载一次。(请用当前版本替换,例如 2.2.0。
概述(AI 翻译)
[!注] 我构建ZenNotes时,借助了Claude和Codex等AI工具的大量帮助。它们让我进展更快,但我仍然会在发布前审查部分代码。架构、技术决策和权衡是我仍然花很多时间思考的。AI帮助我更快写代码,但它不能替代理解系统的工作原理。
ZenNotes 是一款以键盘为先的 Markdown 笔记应用,拥有共享的产品核心和多个运行时:
- 一款使用 Electron 构建的桌面应用
- 由 Go 服务器支持的自托管 Web 应用
- 基于同一Web/服务器栈构建的未来托管部署模式
ZenNotes将你的笔记保存为普通的Markdown文件。它增加了支持Vim的编辑、拆分和预览工作流程、任务、标签、归档/垃圾桶、图表、搜索、每日笔记、CSV数据库(Notion风格的表格+板视图覆盖在普通.csv文件上),以及在你已有文件基础上的MCP集成。
在macOS上,第一方zenCLI也支持启动器工作流,如Raycast扩展。
从GitHub Releases获取最新版本——见下方“安装”。 网站:zennotes.org 支持开发:GitHub 赞助商
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
ZenNotes
[!NOTE] I build ZenNotes with a lot of help from AI tools like Claude and Codex. They let me move much faster, but I still go through some of the code before I ship it. The architecture, the technical decisions, and the trade-offs are things I still spend a lot of time thinking about. AI helps me write code faster, but it doesn’t replace understanding how the system works.
ZenNotes is a keyboard-first Markdown notes app with a shared product core and multiple runtimes:
- a desktop app built with Electron
- a self-hosted web app backed by a Go server
- a future hosted deployment mode built on the same web/server stack
ZenNotes keeps your notes as ordinary Markdown files on disk. It adds Vim-friendly editing, split and preview workflows, tasks, tags, archive/trash, diagrams, search, daily notes, CSV databases (Notion-style Table + Board views over plain .csv files), and MCP integration on top of the files you already own.
On macOS, the first-party zen CLI also powers launcher workflows such as the Raycast extension.
Grab the latest build from GitHub Releases — see Install below.
Website: zennotes.org
Support development: GitHub Sponsors
Detailed in-repo documentation lives under docs/README.md.
Install
All desktop installers are attached to each GitHub Release. The app auto-updates, so you only download once. (Replace `` with the current release, e.g. 2.2.0.)
macOS
Homebrew (recommended):
brew install --cask zennotes/tap/zennotes
Or download the .dmg for your chip, open it, and drag ZenNotes to Applications. Builds are signed and notarized.
- Apple Silicon:
ZenNotes--mac-arm64.dmg - Intel:
ZenNotes--mac-x64.dmg
Windows
Download and run the installer for your PC:
- Intel and AMD:
ZenNotes--win-x64.exe - ARM (Snapdragon and other Windows on ARM):
ZenNotes--win-arm64.exe
Linux
Pick whatever suits your distro:
- Arch / CachyOS / Manjaro — AUR (recommended):
Installs cleanly withoutyay -S zennotes-bin # or: paru -S zennotes-binlibfuse2. - Arch — native package:
sudo pacman -U ZenNotes--linux-x86_64.pacman - Debian / Ubuntu:
sudo apt install ./ZenNotes--linux-amd64.deb - Nix / NixOS: Read packaging/nix/README.md for installation instructions
- Any distro — AppImage:
chmod +x ZenNotes--linux-x86_64.AppImage ./ZenNotes--linux-x86_64.AppImage
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →