Zettlr
Hendrik Erz · A local Markdown writing workbench with project organization, search, citations, split views and publication export workflows.
brew install --cask zettlr- 30-day installs
- 808
- #307 in App
- 1-year installs
- 7.1K
- Last 365 days
- Latest version
- 4.10.0
- Download size
- 203MB
- dmg
- Release cadence
- Every 2 weeks
- 2 releases in 30 days
About
Zettlr is a Markdown-based writing workbench for notes, research and longer publications. It combines a local file workspace with editing, search, references and export workflows so writers can move from early ideas toward a manuscript.
Features
- Edit Markdown documents in organized local workspaces.
- Search across writing projects and navigate document structure.
- Work with supported citation styles and bibliography data.
- Use split views and formatting tools while drafting.
- Export through supported publication formats and configured tools.
- Customize shortcuts, appearance and writing preferences.
Setup and compatibility
The current Mac distribution requires macOS 13 or later; this download is the arm64 build for Apple Silicon. Choose an architecture-compatible release. Add a workspace folder and keep regular backups of your writing. Export and citation workflows can require additional tools or configured bibliography files, so review the official documentation for the output format you need.
Zettlr is free and open source under GNU GPL version 3, supported by donations. Official license. The publisher states that it has no forced cloud synchronization or telemetry and that files stay on your computer. Optional external services, links and tools have separate privacy and licensing terms. Grant file access only to the folders you intend to use and check exported documents, especially citations and complex formatting, before publication.
Sources: Official website, Official releases.
At a glance
- Price
- Free
- System
- macOS 13 or later
- Chip
- Apple silicon · Intel
- Auto-updates
- No
- Repository
- Open source · GPL-3.0 · Updated 0 days ago★14K
- Developer
- Hendrik Erz
- Homebrew
- Available; updated by Homebrew
- Also known as
- zettlr
- Homepage
- www.zettlr.com
- Token
- zettlr
Checked
What’s new in 4.10.0
New · From GitHub Releases
Quality of Life Improvements | Cleanup | Fixes
This new update of Zettlr primarily fixes things that were either broken for some time, or broke in 4.9. However, it also includes a set of features and other improvements that will come in handy.
Among the most notable changes in this update are: (1) attachments specified in BibTeX or BibLaTeX libraries are properly opened via the context menu in Zettlr; (2) Mermaid diagrams will render again; (3) keywords and tags in YAML frontmatters are clickable again; (4) we fixed a bunch of shortcuts that stopped working after the custom shortcut update; (5) the LanguageTool linter now additionally checks various text-fields in your frontmatters; and (6) we have begun homogenizing Zettlr's UI across all platforms. macOS-users should not see many differences, but on Windows and Linux, the app will look considerably different. This change does not affect the placement or functionality of any UI elements, only their styling.
There's much more that has changed, so we again invite you to read the Changelog below before updating. Happy writing!
Do you enjoy Zettlr? Then consider making a donation to help us pay for the development costs. You can donate monthly on Patreon or once via PayPal. Additionally, you can directly sponsor Hendrik Erz on GitHub or send a tip on Ko-Fi. Thanks for your support!
Changelog
GUI and Functionality
- Feature: The context menus for links and images now also feature various items that may be useful for formatting aspects of the link/image descriptions (#6417).
- Feature: Make the "find next" and "find previous" commands of the editor
search configurable. Previously, both
Mod-gandF3would move to the next search result, but after implementing custom shortcuts, these two commands were left unconfigurable and hard-coded toMod-g. These are now configurable so that you can change the default keybinding ofMod-gtoF3if you wish (#6575). - Feature: The LanguageTool linter now also lints text-only properties in
the frontmatter, using the same language as the rest of the document. This
allows spotting issues with these metadata fields as well. Currently, the
linter includes in its detection the following properties:
titlesubtitleabstractabstract-titledescriptionshorttitleshortsubtitlethanks
- Change: The styles and layouts of various UI components have been
adjusted. The following components should now look mostly the same across all
operating systems:
- Toolbar
- File Tree
- Sidebar
- Change: Removed the
.extension from the default new filename pattern in the Advanced Preferences menu. This pattern is used as the filename, so the extension is unnecessary. Previously, creating a new file with the default pattern would result in themd .extension being added twice to markdown files, or added incorrectly to non-markdown files. Existing users should update the pattern manually by removingmd .from it. For new installations, the pattern will be correct. (#6638).md - Change: The layout of the document information popover is now improved. We have moved the bold styling over to the actually important parts, improved legibility of the popover, and included more information -- notably, regardless of which unit (words or characters) you select in the preferences, the popover will now display both numbers, with your preferred one clearly visible.
- Fixed a misaligned size distribution between the file manager, editor view, and sidebar. Now, when double-clicking the dividers between these three components, they will resize so that both sidebars take up 20% of the window width, as opposed to a distribution of 20% for the file manager and ca. 15% for the sidebar. This way, both sidebars of the main window are visually equally sized.
- Fixed a bug where Zettlr would never load attachments from your main
database if that database was in
BibTeXorBibLaTeXformat, as a small logical error made the relevant code for retrieving attachments never find the database in memory and thus would always fall back to attempting to contact Zotero, which would, logically, fail for JabRef users (#6619). - Library loading on boot is now asynchronous, also we register a long-running task during database loads to visualize especially the loading of large library files.
- Fixed a bug that prevented Mermaid diagrams from rendering due to an underlying bug in the new API (#6625).
- Fixed an issue that would cause full-text searches to start even as the input field was still composing non-latin text (#6597; #6604).
- Fixed the spacing on the changelog entries to make it more pleasant to read.
- Fixed an issue that could, under the right circumstances, write unusual values for resized split views into the configuration, necessitating a configuration modification to render Zettlr usable again (#5829).
- Fixes various issues pertaining to keywords/tags which are present in YAML frontmatters of files. Zettlr now again correctly detects these and they are clickable, yielding a search for keywords, which also includes keywords with spaces (#2443; #2590; #4498; see PR #6496).
- Fixed a 404-link to an old documentation page in the onboarding dialog.
- Fixed the LanguageTool language overrides. Previously, if you wanted to change
the language in which LanguageTool would check your document via the
langproperty (e.g.,lang: frto force French instead of autodetection), you had to reload the entire document. Now changes are detected on the fly as you modify thelangproperty in the YAML frontmatter. - Fixed the styles of both subscripts (e.g.,
H~2~O) and superscripts (e.g.,2^10^). Previously, both types of elements were not displayed using a small font and set to super or sub alignment. - The formatting characters for subscripts and superscripts are now appropriately hidden if "Render emphasis" is turned on.
- Fixed many of the newly customizable shortcuts which would mostly work on just macOS, since we accidentally declared the Mac-specific Command-key to be part of the shortcut, instead of also providing an alternative with the Control key. We remain puzzled why nobody complained about this issue since it affected quite a few important shortcuts. (If you are reading this right now, you're not included in this statement ;).
Under the Hood
- Update Electron to
v44..10 - Update Pandoc to
v3.. Caution: Pandoc 3.13 has switched its underlying YAML parser. For the most part, this change should not affect you, but it could if you relied on odd behavior of YAML, such as treating14 noasfalseinstead of a string. If you receive errors during exports, this is a potential cause. - Update the
gettext-parsertov10. - Added error-handling code in case titlebar overlays cannot be set for windows (see #6417).
- Exchanged
biblatex-csl-converterwithbibliojson. - Refactor the splash screen to silence an error caused by a benign race condition during the boot sequence.
- Pin the AppImage toolset in Electron builder to use a more modern one which depends on fuse3 instead of the deprecated fuse2 library. This change must be reverted once Electron builder is updated to v27 (#6632).
- Refactored the
render-codeplugin to allow for a generic set of persistent decorators for various elements.
Full Changelog: https://github.com/Zettlr/Zettlr/compare/v4.9.0...v4.10.0
How to install Zettlr on Mac
Homebrew installs the app in your Applications folder.
Install without Homebrew
Download the file Homebrew uses for your chip: Install Details
Uninstall Zettlr and optional data cleanup
brew uninstall --cask zettlrA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
brew uninstall --zap --cask zettlr--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.
Questions about Zettlr
Is Zettlr safe?
Zettlr is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 808 times through Homebrew in the last 30 days.
Is Zettlr free?
Yes, Zettlr is free to use. Source: www.zettlr.com, checked Oct 26, 2026.
Is Zettlr open source?
Zettlr’s source code is public on GitHub (Zettlr/Zettlr) under the GPL-3.0 license.
How do I completely uninstall Zettlr on a Mac?
Run brew uninstall --cask zettlr. It quits the app. To delete its settings and caches as well, run brew uninstall --zap --cask zettlr. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 5 files and folders, including ~/.
Does Zettlr run on Apple silicon (M1 and later) Macs?
Yes. Homebrew downloads separate builds for Apple silicon and Intel Macs. It needs macOS 13 or later.
Where does Zettlr store its settings and data?
Its settings are in ~/. Its data is in ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of Zettlr?
The latest version is 4.10.0, added to Homebrew on Nov 13, 2026. Run brew upgrade --cask zettlr to update it.
Similar Apps
- MacDown 3000A free Markdown editor for macOS with live preview, syntax highlighting, customizable themes and a Quick Look extension.
- Grammarly DesktopWriting suggestions for supported apps and websites, including grammar, spelling, clarity and tone feedback.
- JoplinAn open-source notes and to-do application with Markdown, attachments, notebooks, optional encrypted synchronization and extensible desktop workflows.
- Markdown PreviewA native Mac Markdown reader with document outlines, Finder Quick Look previews and integrated editing features.