Org-mode
Org Mode is a mode for document editing, formatting, and organizing within the free software text editor GNU Emacs and its derivatives, designed for notes, planning, and authoring. The name is used to encompass plain text files that include simple marks to indicate levels of a hierarchy, and an editor with functions that can read the markup and manipulate hierarchy elements.
Org Mode was created by Carsten Dominik in 2003, originally to organize his own life and work, and since the first release numerous other users and developers have contributed to this free software package. Emacs has included Org Mode as a major mode by default since 2006. Bastien Guerry is the maintainer since 2010, in cooperation with an active development community. Since its success in Emacs, some other systems now provide functions to work with org files.
Almost orthogonally, Org Mode has functionalities aimed at executing code in various external languages; these functionalities form org-babel.
System
The Org Mode home page explains that "at its core, Org Mode is a simple outliner for note-taking and list management". The Org system author Carsten Dominik explains that "Org Mode does outlining, note-taking, hyperlinks, spreadsheets, TODO lists, project planning, GTD, HTML and LaTeX authoring, all with plain text files in Emacs."The Org system is based on plain text files with a simple markup, which makes the files very portable. The Linux Information Project explains that "Plain text is supported by nearly every application program on every operating system".
The system includes a lightweight markup language for plain text files, allowing lines or sections of plain text to be hierarchically divided, tagged, linked, and so on.
Functionality
This section gives some sample uses for the hierarchical display and editing of plain text.- To-do lists often have subtasks, and so lend themselves to a hierarchical system. Org Mode facilitates this by allowing items to be subdivided into simple steps, and given tags and properties such as priorities and deadlines. An agenda for the items to be done this week or day can then be automatically generated from date tags.
- Plain text outlines.
- Org files as interconnected pages of a personal wiki, using the markup for links.
- Tracking bugs in a project, by storing.org files in a distributed revision control system such as Git.
- Extensive linking features, within the same file, to other files, to web pages, to emails, and also allows defining custom links.
Org-babel
Org Mode offers the ability to insert source code in the document being edited, which is automatically exported and/or executed when exporting the document; the result produced by this code can be automatically fetched back in the resulting output.This source code can be structured as reusable snippets, inserted in the source document at the place needed for logical exposition thus allowing this exposition to be independent of the structure needed by the compiler/interpreter.
Together with the markup facilities of org-mode, these two functionalities allow for
- Literate programming, by decoupling the exposition of the functions of a program from its code structure, and
- Reproducible research, by the creation of a consistent document consolidating exposition, original data, analyses, discussion and conclusion, in a way that can be reproduced by any reader using the same software tools.
Integration
Org Mode has some features to export to other formats, and other systems have some features to handle org-mode formats. Further, a full-featured text editor may have functions to handle wikis, personal contacts, email, calendars, and so on; because org-mode is simply plain text, these features could be integrated into org-mode documents as well.From org-mode, add-on packages export to other markup format such as MediaWiki, to flashcard learning systems implementing SuperMemo's algorithms.
Outside of org-mode editors, org markup is supported by the GitLab, GitHub and Gitea code repositories, the JIRA issue tracker, Pandoc and others.
Export examples
Org supports exporting to a variety of formats. Below you may find examples of Org fragments exported to a number of formats.Other formats are supported by dedicated packages.1.1 Sub heading
~~~~~~~~~~~~~~~
Paragraphs are separated by a blank line.
-----------------------------------------
Five dashes is a horizontal rule.
Simple markup produces *bold* and /italic/ text. There's also `code',
and other markups.
Here is a link to the org .
An unordered list:
+ apples
+ oranges
+ pears
An ordered list:
1. lather
2. rinse
3. repeat
Org blocks start with #+begin_BLOCK and end with
#+end_BLOCK. This is a quote block.
You can also have format-specific markup, for some formats.
Markdown
- Heading
- # Sub heading
by a blank line.
---
Three dashes is a horizontal rule.
Simple markup produces **bold**
and *italic* text. There's also
`code`, and other markups.
Here is a link to the
org .
An unordered list:
- apples
- oranges
- pears
An ordered list:
1. lather
2. rinse
3. repeat
!
> Org blocks start with #+beginBLOCK
> and end with #+endBLOCK.
> This is a quote block.
You can also have format-specific markup, for some formats
like HTML
Texinfo
@node Heading
@chapter Heading
@menu
- Sub heading::
@node Sub heading
@section Sub heading
Paragraphs are separated
by a blank line.
Five dashes is a horizontal rule.
Simple markup produces @strong
and @emph text. There's also
@code, and other markups.
Here is a link to the
org @uref.
An unordered list:
@itemize
@item
apples
@item
oranges
@item
pears
@end itemize
An ordered list:
@enumerate
@item
lather
@item
rinse
@item
repeat
@end enumerate
@image
@quotation
Org blocks start with #+begin_BLOCK
and end with #+end_BLOCK.
This is a quote block.
@end quotation
You can also have format-specific markup, for some formats.