Our take
Activeregular commits and releases- Activity
- 90
- Community
- 32
- Issues
- 94
- Pull requests
- 73
+46 stars in the last 30 days
- Releases more often than 93% of the projects we track
- Closes issues faster than 82% of the projects we track
ZenNotes is an actively maintained, MIT-licensed option for keyboard-oriented Markdown workflows, but its development depends heavily on one contributor and its web runtime is still catching up with desktop.
Good fit if
- You want to keep notes as local Markdown files while gaining Vim-friendly editing and built-in organization tools.
- You want an Electron desktop app, or are comfortable self-hosting a web app backed by a Go server.
- You value recent, regular releases and an MIT license, and the project’s contributor concentration is acceptable for your use.
Look elsewhere if
- You need a mature self-hosted web experience at full parity with the desktop app.
- Your team needs development and maintenance to be distributed across multiple contributors.
- You need a hosted, multi-user service now. The README describes hosted mode as planned.
All health signals
| Last commit | 2026-11-05 (today) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 100+ (latest v2.83.0, 2026-11-05) |
| Contributors | 22 (top contributor: 97% of commits) |
| Issues closed, last 90 days | 46+ (typically closed in 0 days) |
| Pull requests merged, last 90 days | 49 (typically merged in 0 days) |
| Project age | 7 months |
Checked on 2026-11-06 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
2,587Forks
158Change since Nov 16, 2026: -1 stars·0 forks
Overview
ZenNotes is a keyboard-first Markdown notes app built around an Electron desktop app and a Go server for self-hosted web use. It keeps notes as ordinary .md files in a vault rather than storing their content in a hidden database, adding editing and organization tools around files you own.
It is aimed at people who want Vim-style keyboard navigation, preview and split-pane workflows, and vault-wide tools without moving their notes into a proprietary format. The desktop app is the more mature runtime; the web app shares the core interface and is suited to private, self-hosted access.
Key Features
- Edit plain Markdown files with Vim motions, a command palette, and configurable keymaps.
- Switch between edit, preview, and split modes, with pinned reference panes and desktop floating windows.
- Organize notes with search, tags, tasks, daily and weekly notes, archive, and trash views.
- Render Mermaid diagrams, KaTeX math, and other supported diagram formats in previews.
- Work with Obsidian-style vault layouts, wiki links, backlinks, local embeds, and loose assets.
- Use the
zenCLI for note and task workflows, or connect MCP-capable tools to the vault. - Run a self-hosted web app backed by a Go server, with configurable vault access and authentication.
Use Cases
- Markdown users who want a keyboard-first editor but want to keep notes in ordinary files.
- Vim users who want note-taking, task handling, and vault search in one desktop app.
- Obsidian vault owners who want to work with their existing root-level notes, links, and assets.
- Home-server users who want browser access to a vault within a private network.
- MCP users who want compatible tools to read, search, and edit the same vault they use directly.
What you need
Detected in the repository
- Node.js >=22.22 (from package.json)
- A Compose file to run it with its related services
- Automated checks on GitHub Actions
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
For desktop development, install dependencies and start the app:
npm ci
npm run dev:desktop
For installation packages, self-hosting, and other workflows, see the README.
Alternatives
- notes: Notes is a cross-platform desktop app with folders, tags, and Kanban, while ZenNotes also supports self-hosted web use and MCP integration.
- inkwell: Inkwell focuses on distraction-free desktop writing with preview, history, and export, rather than ZenNotes' self-hosted server and task, diagram, and MCP features.
- siyuan: SiYuan organizes knowledge as linked content blocks with visual editing and optional AI, while ZenNotes centers on ordinary Markdown files and Vim-friendly editing.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| zennotes | TypeScript | MIT | 2.6k | Active |
| notes | C++ | MPL-2.0 | 4.3k | Quiet |
| inkwell | not specified in the repository metadata. | NOASSERTION. | 254. | Quiet |
| siyuan | TypeScript | AGPL-3.0 | 46.6k | Active |
Considerations
- Desktop is the more mature runtime; the project says web and self-hosted features are still moving toward parity.
- The self-hosted web app requires the separate Go server. Docker is available, but the container can only browse directories mounted into it, and the project recommends keeping it behind a private network gate or reverse proxy.
- The project is active, with frequent commits and releases, but measured contributor activity is highly concentrated in one person. That is a continuity risk despite the broader contributor base.
- The README lists hosted multi-user deployment as a future mode, not a current offering.
- Local development requires Node.js 22.22 or newer; building or running the server path also involves Go.
Found this useful?
Share it with someone who would like zennotes.