Outline-based notes management and organizer
org-9.7pre0.20230608.131413.tar, 2023-Jun-08, 9.32 MiB
Bastien Guerry <>
Browse ELPA's repository
CGit or Gitweb

To install this package, run in Emacs:

M-x package-install RET org RET

Full description

This is a distribution of Org Mode, a major mode for keeping notes, authoring documents, computational notebooks, literate programming, maintaining to-do lists, planning projects, and more — in a fast and effective plain text system.

Check the Org Mode website for more.

1 Install Org

Org is part of GNU Emacs: you probably don't need to install it.

To install a more recent version, please do it from GNU ELPA by running this command: M-x package-install RET org RET

2 Join the GNU Project

Org is part of GNU Emacs and GNU Emacs is part of the GNU Operating System, developed by the GNU Project.

If you are the author of an awesome program and want to join us in writing Free (libre) Software, please consider making it an official GNU program and become a GNU Maintainer. Instructions on how to do this are here

Don't have a program to contribute? Look at all the other ways to help:

And to learn more about Free (libre) Software in general, please read and share this page:

3 License

Org-mode is published under the GNU GPLv3 license or any later version, the same as GNU Emacs.

Org-mode is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Org mode. If not, see

Old versions

org-9.7pre0.20230607.173423.tar.lz2023-Jun-071.56 MiB
org-9.7pre0.20230603.82745.tar.lz2023-Jun-031.56 MiB
org-9.7pre0.20230601.120522.tar.lz2023-Jun-011.56 MiB
org-9.7pre0.20230531.84047.tar.lz2023-May-311.56 MiB
org-9.7pre0.20230518.132249.tar.lz2023-May-181.56 MiB
org-9.7pre0.20230430.195554.tar.lz2023-May-011.56 MiB
org- MiB
org- MiB
org-0.20171225.tar.lz2017-Dec-251.17 MiB
org-0.20121231.tar.lz2012-Dec-311017 KiB


ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-

#+STARTUP: overview

#+LINK: doc
#+LINK: msg
#+LINK: git

Copyright (C) 2012-2023 Free Software Foundation, Inc.
See the end of the file for license conditions.

Please send Org bug reports to

* Version 9.7 (not released yet)
** Important announcements and breaking changes
*** "Priority" used to sort items in agenda is renamed to "urgency"

Previously, ~priority-up~ and ~priority-down~ in
~org-agenda-sorting-strategy~ used a composite rank depending on
item's priority (=[#A]=, =[#B]=, =[#C]=, etc) and overdue time to
order agenda items (see "11.4.3 Sorting of agenda items" section of
Org manual).

Now, this composite rank is renamed to =urgency= and the relevant
sorting strategies are renamed to ~urgency-up~ and ~urgency-down~.
~priority-up~ and ~priority-down~ sort by item's priority only.

Users relying on the previous composite ranking should adjust their
agenda sorting settings.

*** =python-mode.el (MELPA)= support in =ob-python.el= is removed

=python-mode.el= support has been removed from =ob-python.el=.  The
related customization =org-babel-python-mode= has been changed to a

If you still want to use python-mode with ob-python, you might
consider [[][ob-python-mode-mode]], where the code to support python-mode
has been ported to.

*** =ox-icalendar.el= line ending fix may affect downstream packages

iCalendar export now uses dos-style CRLF ("\r\n") line endings
throughout, as required by the iCalendar specification (RFC 5545).
Previously, the export used an inconsistent mix of dos and unix line

This might cause errors in external packages that parse output from
ox-icalendar.  In particular, older versions of org-caldav may
encounter issues, and users are advised to update to the most recent
version of org-caldav.  See [[][this org-caldav commit]] for more information.

** New and changed options
*** Commands affected by ~org-fold-catch-invisible-edits~ can now be customized

New user option ~org-fold-catch-invisible-edits-commands~ controls
which commands trigger checking for invisible edits.

The full list of affected commands is:
- ~org-self-insert-command~
- ~org-delete-backward-char~
- ~org-delete-char~
- ~org-meta-return~
- ~org-return~ (not checked in earlier Org versions)

*** New customization ~org-image-max-width~ limiting the displayed inline image width

New custom variable ~org-image-max-width~ limits the maximum inline
image width, but only when the inline image width is not explicitly
set via ~org-image-actual-width~, =ORG-IMAGE-ACTUAL-WIDTH= property,
or =#+ATTR*= keyword.

By default, when ~org-image-actual-width~ is set to t,
~org-image-max-width~ takes effect.  Its default value is set to
~fill-column~, limiting the image previews to ~fill-column~ number of

To fall back to previous defaults, where the inline image width is not
constrained, set ~org-image-max-width~ to nil.

*** ~org-src-block-faces~ now accepts empty string ~""~ as language name

It is now possible to customize face of source blocks without language specifier.

: #+begin_src
: Source block with no language
: #+end_src

For example, to set ~highlight~ face, use

#+begin_src emacs-lisp
(setq org-src-fontify-natively t)
(add-to-list 'org-src-block-faces '("" highlight))

*** New ~org-cite-natbib-export-bibliography~ option defining fallback bibliography style

~natbib~ citation export processor now uses
~org-cite-natbib-export-bibliography~ (defaults to ~unsrtnat~) as a
fallback bibliography style if none is specified by user in
=#+cite_export:= keyword.

Previously, export would fail without explicitly selected bibliography