14 KB

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

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.

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 [[id:0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26][mailing list]] where questions are answered quickly and effectively.
It's free!
Org is open source software, it is free, like Emacs.

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


  • <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.4)

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

This package works on Emacs 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 CVS Emacs trunk 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 the 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

  • 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 Euro of each book sold is donated to Org mode project.
  • Translations of the manual
  • A Japanese translation of an older version (4.60), by Takeshi
  • Okano.
  • A Spanish translation (version 6.21b).

Reference card


  • Download the Refcard for org-mode
  • There is also a text version of the
  • reference card.
  • The Org Mode FAQ is user-editable and is maintained by the [[][Worg
  • project]].



Talks about Org-mode

Mailing list

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. :PROPERTIES: :ID: 0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26 :END:

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

  • Subscribe to it at the web interface.
  • Directly send mail to it. If you are not subscribed, a moderator
  • will look at the message before passing it through to the list.
  • Read the list on Gmane through a web interface or with a
  • [[news://][newsreader]].
  • Please read the Feedback section of Org's manual before posting a
  • question, it helps getting useful answer. [[][How To Ask Questions The Smart Way]], by E. S. Raymond is also worth reading.
</li><li><form method="get" action=""><div>
<input type="text" name="query" />
<input type="hidden" name="group" value="gmane.emacs.orgmode" />
<input type="submit" value="Search gmane.emacs.orgmode" />


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.