org: Drawers
2.8 Drawers
===========
Sometimes you want to keep information associated with an entry, but you
normally don’t want to see it. For this, Org mode has _drawers_.
Drawers need to be configured with the option ‘org-drawers’(1). Drawers
look like this:
** This is a headline
Still outside the drawer
:DRAWERNAME:
This is inside the drawer.
:END:
After the drawer.
You can interactively insert drawers at point by calling
‘org-insert-drawer’, which is bound to <C-c C-x d>. With an active
region, this command will put the region inside the drawer. With a
prefix argument, this command calls ‘org-insert-property-drawer’ and add
a property drawer right below the current headline. Completion over
drawer keywords is also possible using <M-TAB>.
Visibility cycling (Visibility cycling) on the headline will
hide and show the entry, but keep the drawer collapsed to a single line.
In order to look inside the drawer, you need to move the cursor to the
drawer line and press <TAB> there. Org mode uses the ‘PROPERTIES’
drawer for storing properties (Properties and Columns), and you
changes::) and clock times (Clocking work time) to be stored in
a drawer ‘LOGBOOK’. If you want to store a quick note in the LOGBOOK
drawer, in a similar way to state changes, use
‘C-c C-z’
Add a time-stamped note to the LOGBOOK drawer.
You can select the name of the drawers which should be exported with
‘org-export-with-drawers’. In that case, drawer contents will appear in
export output. Property drawers are not affected by this variable and
are never exported.
---------- Footnotes ----------
(1) You can define additional drawers on a per-file basis with a line
like ‘#+DRAWERS: HIDDEN STATE’