Org-Mode: Your Life in Plain Text

Org - an Emacs Mode for Notes, Project Planning, and Authoring

Org-mode is for keeping notes, maintaining ToDo lists, doing project planning, and authoring with a fast and effective plain-text system.

Shirts and Donations
Promote Org-mode and support its development by getting your Org-mode T-shirt, bag, or mug in either the US-Shop or the EU-Shop
... or by making a direct donation.
... or by "flattring" us!
At its core, Org-mode is a simple outliner for note-taking and list management. You can learn the basics for using it in five minutes. This may be all you need, and Org-mode will not impose more complex features on you.
Org files are plain text. You can view and edit them in any editor, or add and extract data with custom-made scripts. Your data will never be locked into an obscure or proprietary data format. Org-mode runs in Emacs, which is available for nearly every platform.
Org-mode will not let you down when you need more than a simple outline. The full feature set is both broad and deep, easy to access, but unobtrusive. The typical answer to "Can it do X?" is "Yes!".
Org-mode is like a Swiss army knife. People use it for Getting Things Done (GTD), as a Day Planner, as a Notebook, for Web and PDF Authoring, and much more.
Org-mode is documented extensively, and many tutorials put spotlights on particular features. Org-mode is supported by an active mailing list where questions are answered quickly and effectively.
It's free!
Org is free software, it is published under the GNU GPL license, like GNU Emacs

If you'd like to know what other people have said about Org-mode, take a look at our collected quotes about Org.

Table of Contents



  • 2011-07-06 mer. Release 7.6.
  • 2011-03-07 lun. Release 7.5.
  • 2010-12-17 Fri The Org manual is now available as book published by Network Theory Ltd, at a retail price of $14.95. For each book sold, $1 is donated to the Org project.
  • 2010-12-10 Fri: Release 7.04.
  • 2010-12-03 Fri: MobileOrg for Android supports Voice Capture
  • 2010-11-25 Thu: Maybe the times where Org mode could change hard-core vi users into honorable Emacs users are coming to an end? A Vim clone of Org mode is be written by Herbert Sitz, and judging by the videos it looks promising.
  • 2010-06-06 Sun: iPhone App MobileOrg version 1.5 introduces encryption.

Current Version (7.6)

The current version is 7.6. To see what has changed in recent releases, check this detailed list of changes.

This package works on GNU Emacs 24, 23 and 22, and (with minor restrictions) on XEmacs 21. Emacs 22.2 ships with Org-mode version 4.67d, Emacs 23.1 with 6.21b. The latest Emacs development version usually contains a fairly recent version, but may lag a bit behind the website release.


The standard distribution

Download as zip file or gzipped tar archive. These archives contain both the Lisp file org.el and the documentation in PDF and (TeX)Info formats. Follow the instructions for Installation and Activation.

The development version

You can check out the latest Org development version (along with every release we ever had) by using git. The git repository is browsable online. At any time you can get a snapshot of the files in it. To get a local clone of the repository use something like the following (from the command line….):

git clone git://

Some more information about this can be found in the FAQ, under How do I keep current with Org mode development?. For people who cannot use git, we provide zip or tar.gz snapshot release files updated each day and corresponding to the latest git version. Alternatively, you can also download a tar.gz snapshot from server.

Alternative distributions

There are several alternative distributions of Org. Some of these are more up-to-date than others, so check if this package really has a recent version


The Org guide and manual

  • Links below point to the development version of the manual. If you want to read the latest released manuals (currently for Org 7.6), please browse this directory.
  • Read the online compact guide or download it as a PDF document. The compact guide is a 40-page introduction to Org mode. It covers all features in a basic way and has links to in-depth documentation in the manual and on the web.
  • Read the online manual. The manual covers the complete feature set with all the bells and whistles, in a systematic way. The main structure is identical to the guide, so it is easy to go back and forth between basic and advanced documentation.
  • You can also have the entire manual in a single monolithic file.
  • Download the manual as a 200-page PDF document.
  • Buy a paperback edition of the manual from Network Theory Ltd. One USD of each book sold is donated to Org mode project.
  • Translations of the manual

Reference card




Talks about Org-mode

Check out the Google Tech Talk about Org-mode, or another talk given at the Max Planck Institute for Neurological Research. On FLOSS Weekly show number 136 Randal Schwartz interviews Carsten about Org mode.

Bastien presented Org at FOSDEM 2011, with the help of Stefan Vollmar (presenting a use-case from his lab) and S├ębastien Vauban (presenting Org Babel). You can find the slides of Bastien's presentation here.

Mailing list

There is a mailing list for discussion about org-mode.

  • MobileOrg

    MobileOrg is an excellent open source application to read and change Org-files on the road, using an iPhone, and then sync the changes back to your computer. Check out Richard's page.

    Matt Jones is currently developing a compatible application for Android, and this project is hosted here.


    Worg, created by Bastien Guerry, is a setup to allow users to jointly edit a number of Org-mode files containing documentation about Org-mode, including the Org Mode FAQ and Tutorials. Worg is similar to a wiki in that allows community to edit the contents. However, since it uses a distributed version control system, you do not have to be online while editing it. If you'd like to contribute to Worg, please go to the Worg page, and start from there.

    Contributing to Org-mode

    You can always contribute with ideas and bug reports on the mailing list. If you want to contribute a patch, code snippets, or a full add-on, this is very welcome too! Detailed information on how and what to contribute can be found here.

    Date: 2011-07-22 09:38:21 UTC

    Org version 7.6 with Emacs version 23

    Validate XHTML 1.0