ZZ

zennotes/zennotes

开发工具官方

本页由 AI 翻译,技术细节请以原文为准。 查看原文

2567 stars 153 forks 质量 67 趋势 49MIT

以键盘为先的本地 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):
    yay -S zennotes-bin     # or: paru -S zennotes-bin
    
    Installs cleanly without libfuse2.
  • 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
    
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →