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 (SeeVisibility 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 (SeeProperties and Columns), and you
 changes::) and clock times (SeeClocking 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’