View and edit Markdown files for free.And work on them with your AI agent.

Open individual Markdown files in a focused window and edit them together with your AI agent in real time. You can work side by side, or hand your agent full control.

Support Zettelblock
  • Windows, Mac and Linux
  • Free and open source
  • No account, no telemetry
  • Works offline
Press Enter to type in the demo. Press Esc to leave it.

Simulated agent. Your agent uses the zblock command.

Collaborate with your agent in the same file and track every change.

Your agent connects to Zettelblock through the command line (zblock) or MCP, and starts it if it isn’t running yet. While it edits the file you have open, you can keep writing, because its changes leave your cursor and your scroll position where they are. If you’d rather watch, give your agent full control, and it opens the file, scrolls to its edit and selects it for you.

Open and show files

Your agent opens, creates and closes files in tabs, and can show each one as Markdown, plain text or a table.

Read and edit

Your agent reads the text as you see it, unsaved changes included, and changes only what it needs to.

Select and scroll

Your agent can read what you selected, select text for you, and scroll to a line or a heading.

Settings and window

Your agent can set the theme, zoom, text width or spell check languages, and with your permission, your shortcuts.

Works with your AI agent of choice

Run zblock connect once, or turn it on in Settings → Agents, and Zettelblock installs a skill for Claude Code, Codex or OpenCode. Chat apps without a terminal can use the optional MCP server, zblock mcp, instead.

Open notes.md in Zettelblock and make the second paragraph shorter.

I'll open it in Zettelblock first, so you can follow along.

zblock open notes.md

zblock read

The second paragraph says the same thing twice. I'll cut it to one sentence.

notes.md1 change

Done. The open tab shows the shorter paragraph, and your cursor is where you left it.

Features

Single files, no setup

Open any .md file from your file manager, with Ctrl+O (Cmd+O on a Mac), by drag and drop, or with zblock open.

Live Markdown formatting

Headings, lists, tables, code, math and callouts show styled while you write, and the Markdown marks appear only where your cursor is.

Keep working where you left off

When you start Zettelblock again, your tabs come back at the same line, with the cursor where you left it. And if you close a tab by mistake, a shortcut opens it again.

Intuitive table editor

Start a table by typing it in Markdown or by pasting cells from a spreadsheet or a web page, then edit and resize the table as you like. The editor is flexible, but what it saves is always a plain Markdown table.

Split the window into panes

Drag a tab to the edge of a pane to split the window, with room for up to three panes across and three down. Keep your notes beside a draft, or watch your agent work in one file while you write in another.

Separate change histories

Changes from your agent, or from any other program, stay out of your own undo history, so the two never get tangled. Undo the agent's newest edit with one command, or pick an earlier round from the history and see exactly which lines it changed.

Auto save and instant refresh

Zettelblock saves 300 ms after you stop typing. When another program changes the file, the tab shows the change at once.

Quiet themes

There are four themes, each in light and dark: Blatt (leaf), Papier (paper), Moos (moss) and Tinte (ink). On top of that, you can choose the colors of links, headings and other parts of the text.

Private and offline

Zettelblock has no telemetry, you need no account, and your files stay on your computer. The app only goes online to load a web image that a file links to, and to look for and download updates, based on your settings.

Get Zettelblock for your computer

Pick the build for your system. Zettelblock runs on Windows, Mac and Linux.

Windows

Installer for 64-bit Windows.

macOS

Disk image for Macs with Apple silicon or Intel.

Linux

Pick the .deb or the .rpm package.

Questions and answers

Which systems does Zettelblock run on?

Zettelblock is available for Windows, Mac and Linux.

Which files does Zettelblock open?

Markdown files (.md and similar endings) open in the live preview. Zettelblock also opens .txt, .log, .json, .yaml, .toml, .ini, .xml, .csv and .tsv files, where JSON, YAML, TOML, INI and XML show with syntax colors and CSV and TSV show as a table. If you want a different view for a tab, choose “View as” in its right-click menu.

How does Zettelblock update?

On the first start, Zettelblock asks you how you want updates: manually, with a notice when there is a new version, or automatically. Until you answer, or until you check by hand, Zettelblock contacts no update server. The Windows version and the macOS app in your Applications folder update themselves. With the .deb or .rpm package, or a macOS app started from the disk image, Zettelblock shows that there is an update and links to the download section.

What does Zettelblock cost?

Nothing. Zettelblock is free for everyone, also in companies and for client work, and it is open source under the MIT License.

Do I need an account?

No. Zettelblock has no account and no sign-in. It simply opens the files on your computer, and it works offline.

Which AI agents work with Zettelblock?

Claude Code, Codex, OpenCode and other agents that can run commands in a terminal all work. zblock connect installs the skill that shows them how. For chat apps without a terminal there is an optional MCP server, zblock mcp. Even agents that change the file on disk with their own tools work, because the open tab updates at once.

Can I limit what my agent can do?

Yes. In Settings → Agent permissions, you turn each agent action on or off. By default, all actions are on, except changing your keyboard shortcuts. When an action is off and an agent tries it, the agent gets an error and tells you where to turn it on. Only you can change the switches. An agent cannot turn one back on. Note: the switches cover what agents do through Zettelblock. An agent with its own file tools can still change files on disk. If the file is open in Zettelblock, you can take that change back with Undo agent change.

Can I undo what my agent changed?

Yes. After a change from outside, a bar at the top of the tab shows who made it: “An agent” or “A program on disk”. Undo agent change takes back the newest change while your own later edits stay, and you can repeat it to go further back. Redo agent change brings a change back. This does not affect your own undo and redo history. If you have edited the agent’s text since, Zettelblock leaves the change in place and opens the History with a note instead.

What does the History of a tab keep?

While Zettelblock is open, the History of a tab keeps the last 20 rounds of changes from outside. A round collects the changes that come less than 5 seconds apart, and for each one you see the time, whether an agent or a program on disk changed the file, and the lines added and removed. Select a round to see the differences and restore the text from before it, which your normal undo can take back. The History lives in memory only, so Zettelblock does not write it to disk or send it anywhere, and it clears when you close the tab or Zettelblock.

Where are my files?

On your computer. Zettelblock opens and saves each file where it is. There is no cloud and no sync.

Are you enjoying Zettelblock? Please support it.

Zettelblock is free and open source. If it helps you, you can say thanks by buying a digital thank-you note.

MIT License

Copyright (c) 2026 Tristan Ripke

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.