Org's mental model

Markdown primarily describes how text should be rendered. Org also describes structure and behavior.

* TODO Prepare the release                         :software:
DEADLINE: <2026-09-18 Fri>
:PROPERTIES:
:OWNER:    Maya
:EFFORT:   3:00
:END:

The release requires a clean migration test.

- [ ] Run the test suite
- [ ] Update the deployment notes

A heading can simultaneously be a section of a book, a task with a deadline, a database-like record with properties, a clockable unit of work, and a target visible in a computed agenda.

The text is the source of truth. Agenda does not copy this task; it computes a view of it. Export does not replace the file; it transforms it. Babel does not turn Org into a proprietary notebook; it evaluates marked source blocks and writes results back according to declared rules.

This is why “Markdown with extra features” is inadequate. Org is an interactive outline data model, a command set, parsers, exporters, and conventions built on plain text. Its cost is equally real: Emacs has a learning curve, collaboration is not Google Docs-like, mobile clients are third-party, and a highly customized setup becomes software that you must maintain.

A short history

GNU Emacs descends from the extensible Emacs editor tradition begun in the 1970s; GNU Emacs was launched by Richard Stallman in 1984. Carsten Dominik began Org as an outlining and planning mode, announced it publicly in 2003, and developed the compositional model that still defines it. Org entered GNU Emacs in 2006. Bastien Guerry maintained it from 2011 through 2024; Ihor Radchenko became maintainer in December 2024. Babel, created chiefly by Eric Schulte with Dan Davison, joined Org core in version 7.0.

Version discipline in 2026

GNU publishes Emacs 30.2 as the stable release (14 August 2025). The current Org manual identifies Org 9.8. Emacs ships a bundled Org; GNU ELPA and Org's repository may provide a newer build. Mixing installation methods can load old and new libraries in one session, producing baffling errors. Prefer the bundled version while learning. If upgrading, follow Org's official isolated-upgrade procedure and verify with M-x org-version.

Old web advice needs scrutiny. The modern citation system uses org-cite syntax, not only older org-ref recipes. org-structure-template-alist plus C-c C-, superseded the old <s TAB shortcut unless org-tempo is explicitly enabled. Current Emacs has built-in use-package and package-vc; neither requires a third-party bootstrap.

Summary. Org is an outliner first. Tasks, notes, computation, and export are different interpretations of the same structured text. Version awareness prevents most configuration folklore from becoming your problem.