In-buffer settings start with ‘#+’, followed by a keyword, a colon, and then a word for each setting. Org accepts multiple settings on the same line. Org also accepts multiple lines for a keyword. This manual describes these settings throughout. A summary follows here.
C-c C-c activates any changes to the in-buffer settings. Closing and reopening the Org file in Emacs also activates the changes.
Sets the archive location of the agenda file. This location applies to the
lines until the next ‘#+ARCHIVE’ line, if any, in the Org file. The
first archive location in the Org file also applies to any entries before it.
The corresponding variable is
Sets the category of the agenda file, which applies to the entire document.
Sets the default format for columns view. Org uses this format for column
views where there is no
Set file-local values for constants that table formulas can use. This line
sets the local variable
org-table-formula-constants-local. The global
version of this variable is
Set tags that all entries in the file will inherit from here, including the top-level entries.
Each line specifies one abbreviation for one link. Use multiple
#+LINK: lines for more, see Link abbreviations. The corresponding
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.
The setup file or a URL pointing to such file is for additional in-buffer settings. Org loads this file and parses it for any settings in it only when Org opens the main file. If URL is specified, the contents are downloaded and stored in a temporary file cache. C-c C-c on the settings line will parse and load the file, and also reset the temporary file cache. Org also parses and loads the document during normal exporting process. Org parses the contents of this document as if it was included in the buffer. It can be another Org file. To visit the file (not a URL), C-c ' while the cursor is on the line with the file name.
Startup options Org uses when first visiting a file.
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 of
t, which is the same
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
Aligns tables consistently upon visiting a file; useful for restoring
narrowed table columns. The corresponding variable is
nil as default value.
align align all tables noalign don’t align tables on startup
Whether Org should automatically display inline images. The corresponding
org-startup-with-inline-images, with a default value
nil to avoid delays when visiting a file.
inlineimages show inline images noinlineimages don’t show inline images on startup
Whether Org should automatically convert LaTeX fragments to images. The
org-startup-with-latex-preview, which controls this setting,
is set to
nil by default to avoid startup delays.
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
These options hide leading stars in outline headings, and indent outlines.
The corresponding variables are
org-odd-levels-only, both with a default setting of
hidestars hide all stars on the headline except one. showstars show all stars on the headline indent virtual indents according to the outline level noindent no virtual indents odd show odd outline levels only (1,3,...) oddeven show 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
For footnote settings, use the following keywords. The corresponding
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 specify valid tags for this file. Org accepts multiple tags
lines. Tags could correspond to the fast tag selection keys. The
corresponding variable is
This line is for formulas for the table directly above. A table can have multiple ‘#+TBLFM:’ lines. On table recalculation, Org applies only the first ‘#+TBLFM:’ line. For 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 significance to the current file.
The corresponding variable is