Org mode uses special lines in the buffer to define settings on a per-file basis. These lines start with a ‘#+’ followed by a keyword, a colon, and then individual words defining a setting. Several setting words can be in the same line, but you can also have multiple lines for the keyword. While these settings are described throughout the manual, here is a summary. After changing any of those lines in the buffer, press C-c C-c with the cursor still in the line to activate the changes immediately. Otherwise they become effective only when the file is visited again in a new Emacs session.
This line sets the archive location for the agenda file. It applies for
all subsequent lines until the next ‘#+ARCHIVE’ line, or the end
of the file. The first such line also applies to any entries before it.
The corresponding variable is
This line sets the category for the agenda file. The category applies for all subsequent lines until the next ‘#+CATEGORY’ line, or the end of the file. The first such line also applies to any entries before it.
Set the default format for columns view. This format applies when
columns view is invoked in locations where no
Set file-local values for constants to be used in table formulas. This
line sets the local variable
The global version of this variable is
Set tags that can be inherited by any entry in the file, including the top-level entries.
Set the file-local set of additional drawers. The corresponding global
These lines (several are allowed) specify link abbreviations.
See Link abbreviations. The corresponding variable is
This line sets the limits and the default for the priorities. All three must be either letters A–Z or numbers 0–9. The highest priority must have a lower ASCII number than the lowest priority.
This line sets a default inheritance value for entries in the current buffer, most useful for specifying the allowed values of a property.
This line defines a file that holds more in-buffer setup. Normally this is entirely ignored. Only when the buffer is parsed for option-setting lines (i.e., when starting Org mode for a file, when pressing C-c C-c in a settings line, or when exporting), then the contents of this file are parsed as if they had been included in the buffer. In particular, the file can be any other Org mode file with internal setup. You can visit the file the cursor is in the line with C-c '.
This line sets options to be used at startup of Org mode, when an Org file is being visited.
The first set of options deals with the initial visibility of the outline
tree. The corresponding variable for global default settings is
org-startup-folded, with a default value
t, which means
overview top-level headlines only content all headlines showall no folding of any entries showeverything show even drawer contents
Dynamic virtual indentation is controlled by the variable
indent start with
org-indent-modeturned on noindent start with
Then there are options for aligning tables upon visiting a file. This
is useful in files containing narrowed table columns. The corresponding
org-startup-align-all-tables, with a default value
align align all tables noalign don’t align tables on startup
When visiting a file, inline images can be automatically displayed. The
corresponding variable is
org-startup-with-inline-images, with a
nil to avoid delays when visiting a file.
inlineimages show inline images noinlineimages don’t show inline images on startup
When visiting a file, LaTeX fragments can be converted to images
automatically. The variable
controls this behavior, is set to
nil by default to avoid delays on
latexpreview preview LaTeX fragments nolatexpreview don’t preview LaTeX fragments
Logging the closing and reopening of TODO items and clock intervals can be
configured using these options (see variables
logdone record a timestamp when an item is marked DONE lognotedone record timestamp and a note when DONE nologdone don’t record when items are marked DONE logrepeat record a time when reinstating a repeating item lognoterepeat record a note when reinstating a repeating item nologrepeat do not record when reinstating repeating item lognoteclock-out record a note when clocking out nolognoteclock-out don’t record a note when clocking out logreschedule record a timestamp when scheduling time changes lognotereschedule record a note when scheduling time changes nologreschedule do not record when a scheduling date changes logredeadline record a timestamp when deadline changes lognoteredeadline record a note when deadline changes nologredeadline do not record when a deadline date changes logrefile record a timestamp when refiling lognoterefile record a note when refiling nologrefile do not record when refiling logdrawer store log into drawer nologdrawer store log outside of drawer logstatesreversed reverse the order of states notes nologstatesreversed do not reverse the order of states notes
Here are the options for hiding leading stars in outline headings, and for
indenting outlines. The corresponding variables are
org-odd-levels-only, both with a
hidestars make all but one of the stars starting a headline invisible. showstars show all stars starting a headline indent virtual indentation according to outline level noindent no virtual indentation according to outline level odd allow only odd outline levels (1,3,...) oddeven allow all outline levels
To turn on custom format overlays over timestamps (variables
customtime overlay custom time format
The following options influence the table spreadsheet (variable
constcgs constants.el should use the c-g-s unit system constSI constants.el should use the SI unit system
To influence footnote settings, use the following keywords. The
corresponding variables are
fninline define footnotes inline fnnoinline define footnotes in separate section fnlocal define footnotes near first reference, but not inline fnprompt prompt for footnote labels fnauto create
[fn:1]-like labels automatically (default) fnconfirm offer automatic label for editing or confirmation fnplain create
-like labels automatically fnadjust automatically renumber and sort footnotes nofnadjust do not renumber and sort automatically
To hide blocks on startup, use these keywords. The corresponding variable is
hideblocks Hide all begin/end blocks on startup nohideblocks Do not hide blocks on startup
The display of entities as UTF-8 characters is governed by the variable
org-pretty-entities and the keywords
entitiespretty Show entities as UTF-8 characters where possible entitiesplain Leave entities plain
These lines (several such lines are allowed) specify the valid tags in
this file, and (potentially) the corresponding fast tag selection
keys. The corresponding variable is
This line contains the formulas for the table directly above the line.
Table can have multiple lines containing ‘#+TBLFM:’. Note that only the first line of ‘#+TBLFM:’ will be applied when you recalculate the table. For more details see Using multiple #+TBLFM lines in Editing and debugging formulas.
These lines provide settings for exporting files. For more details see Export settings.
These lines set the TODO keywords and their interpretation in the
current file. The corresponding variable is
Emacs 23 and Org mode 6.29 are required