GNU ELPA - org

org Atom Feed

Outline-based notes management and organizer
org-9.7.7.tar (.sig), 2024-Jul-13, 9.69 MiB
Bastien Guerry <>
Browse ELPA's repository
CGit or Gitweb

To install this package from Emacs, use package-install or list-packages.

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 use command: M-x list-packages, find "org" in the list, click on it, and click "Install" in the popped up window.

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.7.6.tar.lz2024-Jun-281.63 MiB
org-9.7.5.tar.lz2024-Jun-221.63 MiB
org-9.7.4.tar.lz2024-Jun-151.63 MiB
org-9.7.3.tar.lz2024-Jun-061.63 MiB
org-9.7.2.tar.lz2024-Jun-031.63 MiB
org-9.7.1.tar.lz2024-Jun-011.63 MiB
org-9.6.30.tar.lz2024-May-101.54 MiB
org-9.6.29.tar.lz2024-May-031.54 MiB
org-9.6.28.tar.lz2024-Apr-261.54 MiB
org-9.6.19.tar.lz2024-Feb-111.54 MiB
org-9.6.3.tar.lz2023-Apr-021.54 MiB
org-9.6.1.tar.lz2023-Jan-111.54 MiB
org-9.6.tar.lz2022-Nov-291.54 MiB
org-9.5.5.tar.lz2022-Sep-031.45 MiB
org-9.5.4.tar.lz2022-Jun-031.44 MiB
org-9.5.3.tar.lz2022-Apr-191.44 MiB
org-9.4.6.tar.lz2021-May-191.38 MiB
org-9.3.8.tar.lz2020-Sep-071.21 MiB
org-9.2.6.tar.lz2019-Sep-041.19 MiB
org-9.1.14.tar.lz2018-Aug-271.17 MiB


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

#+STARTUP: overview

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

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

Please send Org bug reports to

* Version 9.7

** Important announcements and breaking changes

# Here, we list the *most important* changes and changes that _likely_
# require user action for most Org mode users.
# Sorted from most important to least important.
*** Arbitrary shell commands may no longer run when turning on Org mode

This is for security reasons, to avoid running malicious commands.

*** =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.
*** It is no longer possible to reveal hidden parts of the links during isearch

Org 9.6 introduced support for searching hidden parts of the links.

Unfortunately, we had to drop this support because its implementation
turned out to be unreliable for many users. Proper implementation
would require patching =isearch.el= and possibly a number of external
libraries implementing isearch equivalents. It cannot be done on Org
side alone.

*** =ox-latex=: ~org-latex-line-break-safe~ is deprecated

~org-latex-line-break-safe~ constant was previously introduced to deal
with edge cases when LaTeX interprets [...] as LaTeX command
argument.  However, it caused a number of other issues and proved
itself not to be as "safe" as it supposed to be.

We now use a Pandoc's approach to deal with the same problem,
utilizing ={[}= to escape =[...]= instances where needed.

*** ~tab-width~ value is now assumed to be 8

Org mode now assumes tab width to be 8 characters, when calculating
list and other indentation.  ~tab-width~ is also set to 8 when Org
major mode is loaded.

This is done to improve consistency of the markup for lists, where
indentation affects list items.

Users with non-default values of ~tab-width~ should avoid overriding
the value of 8 set by Org mode.  If the custom ~tab-width~ value is
_smaller_ than 8, the existing Org documents can be converted to the
new standard tab width using the following helper command:

#+begin_src emacs-lisp
(defun org-compat-adjust-tab-width-in-buffer (old-width)
  "Adjust visual indentation from `tab-width' equal OLD-WIDTH to 8."
  (interactive "nOld `tab-width': ")
  (cl-assert (derived-mode-p 'org-mode))
  (unless (= old-width 8)
     (goto-char (point-min))
     (let (bound
	   (repl (if (< old-width 8)
		     (make-string old-width ?\s)
                   (concat "\t" (make-string (- old-width 8) ?\s)))))
       (while (re-search-forward "^ *\t" nil t)
	 (skip-chars-forward " \t")
	 (setq bound (point-marker))
	 (forward-line 0)
	 (while (search-forward "\t" bound t)
	   (replace-match repl)))))))

*** ~org-ctags~ is not activated by default any more

To follow Emacs [[info:elisp#Coding Conventions][coding conventions]] and to avoid confusion of users
who accidentally get ~org-ctags~ autoloaded due to help completion,
the library does not modify ~org-open-link-functions~ during loading
any more.  Run ~org-ctags-enable~ to setup hooks and advices:

#+begin_src emacs-lisp
(with-eval-after-load "org-ctags"

*** "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