ZenNotes

zennotes: Keep Markdown Notes in an Electron App and Web Server

ZenNotes is a keyboard-first Markdown notes app built with Electron for desktop and a Go server for self-hosted web use. It keeps notes as ordinary local files and adds Vim-friendly editing, search, diagrams, tasks, and MCP integration.

Stars
2.6k
Forks
154
Stars, last 30 days
+46
Last commit
today
Contributors
22

Our take

Activeregular commits and releases

Health score

72/100

How it is scored
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 commit2026-11-05 (today)
Commits, last 90 days100+
Releases, last 12 months100+ (latest v2.83.0, 2026-11-05)
Contributors22 (top contributor: 97% of commits)
Issues closed, last 90 days46+ (typically closed in 0 days)
Pull requests merged, last 90 days49 (typically merged in 0 days)
Project age7 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.

Selected snapshot

Stars

2,587

Forks

158

Change 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 zen CLI 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.
ProjectLanguageLicenseStarsStatus
zennotesTypeScriptMIT2.6kActive
notesC++MPL-2.04.3kQuiet
inkwellnot specified in the repository metadata.NOASSERTION.254.Quiet
siyuanTypeScriptAGPL-3.046.6kActive

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.

Comparisons