# Zettlr

A local Markdown writing workbench with project organization, search, citations, split views and publication export workflows.

> This is the Markdown version of the Zettlr page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/zettlr>

- **Latest version**: `4.10.0`
- **Developer**: Hendrik Erz
- **Homepage**: <https://www.zettlr.com/>
- **Categories**: [Writing & Notes](https://opennavo.com/categories/writing)
- **Install**: `brew install --cask zettlr`
- **30-day installs**: 808
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/Zettlr/Zettlr/releases/download/v4.10.0/Zettlr-4.10.0-arm64.dmg>
- **SHA-256**: `e20016dfa854be12f9559f10900e0a2f1e12aa0d9dac60a1ef3ab42e56d04abc`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.zettlr.app"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Zettlr.app"
      ],
      "target": "/Applications/Zettlr.app"
    },
    "phase": "install",
    "sources": [
      "Zettlr.app"
    ],
    "target": "/Applications/Zettlr.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.zettlr.app.sfl*",
            "~/Library/Application Support/zettlr",
            "~/Library/Logs/Zettlr",
            "~/Library/Preferences/com.zettlr.app.plist",
            "~/Library/Saved Application State/com.zettlr.app.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 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](https://github.com/Zettlr/Zettlr/blob/develop/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](https://www.zettlr.com/), [Official releases](https://github.com/Zettlr/Zettlr/releases).

## System requirements

- macOS 13 or later · Version: 4.10.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · Checked 2026-11-22
  - <https://github.com/Zettlr/Zettlr/releases/download/v4.10.0/Zettlr-4.10.0-x64.dmg>
  - SHA-256: `df84b4ed3a732c94759be83f0b19fbd757584d753503512d06dd8503ef64b165`
- macOS 13 or later · Version: 4.10.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · Checked 2026-11-22
  - <https://github.com/Zettlr/Zettlr/releases/download/v4.10.0/Zettlr-4.10.0-arm64.dmg>
  - SHA-256: `e20016dfa854be12f9559f10900e0a2f1e12aa0d9dac60a1ef3ab42e56d04abc`

## Zettlr security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/Zettlr/Zettlr> · Open source: Yes — <https://github.com/Zettlr/Zettlr> · Checked 2026-11-14

## Uninstall

- `brew uninstall --cask zettlr`

A 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`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.zettlr.app.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/zettlr` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/Zettlr` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.zettlr.app.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.zettlr.app.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 4.10.0 (2026-11-13)

**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](https://www.patreon.com/zettlr) or [once via PayPal](https://www.paypal.me/hendrikerz). Additionally, you can directly [sponsor Hendrik Erz on GitHub](https://github.com/sponsors/nathanlesage) or [send a tip on Ko-Fi](https://ko-fi.com/hendrikerz). 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-g` and `F3` would move to the next
  search result, but after implementing custom shortcuts, these two commands
  were left unconfigurable and hard-coded to `Mod-g`. These are now configurable
  so that you can change the default keybinding of `Mod-g` to `F3` if 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:
    - `title`
    - `subtitle`
    - `abstract`
    - `abstract-title`
    - `description`
    - `shorttitle`
    - `shortsubtitle`
    - `thanks`
- **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 `.md` 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 the `.md` extension being added twice to markdown
  files, or added incorrectly to non-markdown files. Existing users should
  update the pattern manually by removing `.md` from it. For new installations,
  the pattern will be correct. (#6638).
- **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 `BibTeX` or `BibLaTeX` format, 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 `lang`
  property (e.g., `lang: fr` to force French instead of autodetection), you had
  to reload the entire document. Now changes are detected on the fly as you
  modify the `lang` property 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.14`. **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 treating `no` as `false`
  instead of a string. If you receive errors during exports, this is a potential
  cause.
- Update the `gettext-parser` to `v10`.
- Added error-handling code in case titlebar overlays cannot be set for windows
  (see #6417).
- Exchanged `biblatex-csl-converter` with `bibliojson`.
- 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-code` plugin 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

## Facts and sources

- <https://opennavo.com/apps/zettlr>
- <https://opennavo.com/apps/zettlr/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zettlr.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/zettlr>
- <https://github.com/Zettlr/Zettlr> · Checked 2026-11-14
