blue-dog / zettlr

A powerful markdown editor.

Zettlr [ˈset·lər]

With Zettlr, writing professional texts is easy and motivating: Whether you are a college student, a researcher, a journalist, or an author — Zettlr has the right tools for you. Watch the video or continue reading to see what they are!

Visit the Website.

Features

• File-agnostic writing: Enjoy full control over your own files
• Keep all your notes and texts in one place — searchable and accessible
• Night Mode support
• Cite with Zettlr using citeproc and your existing literature database
• Code highlighting for most contemporary programming languages
• Simple and beautiful exports with Pandoc, LaTeX, and Textbundle
• Support for state of the art knowledge management techniques (Zettelkasten)
• A revolutionary search algorithm with integrated heatmap

… and the best is: Zettlr is Open Source!

Get Zettlr

To install Zettlr, just download the latest release for your operating system! Currently supported are macOS, Windows, and Debian- and Fedora-based Linux systems. (And every other system electron runs on, if you build the app yourself).

Please also consider a donation!

What next?

If you have downloaded Zettlr, head over to our website to get to know Zettlr. Refer to the Quick Start Guide, if you prefer to use software heads-on.

Developing

Zettlr is an electron-based app, so to start developing, you'll need to have a NodeJS-stack on your computer installed. Make sure node and preferably Yarn are installed, which is the recommended package manager.

Then, simply clone the repository and install the dependencies on your local computer:

$ git clone https://github.com/Zettlr/Zettlr.git
$ cd Zettlr
$ yarn install # Or npm install
$ cd source
$ yarn install # Or npm install

(Please note the second yarn install/npm install in the source directory. This is necessary to build the app locally.)

There are four types of templates shipped with the app that need a rebuild once you change them: The stylesheets, which are written in LESS, the HTML templates, written in Handlebars.js, and some components, written in Vue.js. Additionally, the template for the reveal.js-presentations needs to be built prior to running the app. Whenever you make changes to any of these resources, you'll need to recompile them using an appropriate command:

$ yarn less # Or npm run less, this recompiles the stylesheets
$ yarn handlebars # Or npm run handlebars, this recompiles the templates
$ yarn wp:dev # Or npm run wp:dev, this recompiles the Vue components
$ yarn reveal:build # Or npm run reveal:build, needs to be run once

To dive deeper into the development process, have a look at our full development documentation.

License

This software is licensed via the GNU GPL v3-License.

The brand (including name, icons and everything Zettlr can be identified with) is exluded and all rights reserved. If you want to fork Zettlr to develop another app, feel free but please change name and icons.