17.4 Keywords or Attributes

Most element types can be assigned attributes. This is done by adding specific keywords, named “affiliated keywords”, just above the element considered, with no blank line allowed. Affiliated keywords are built upon one of the following patterns:

#+KEY: VALUE
#+KEY[OPTIONAL]: VALUE
#+ATTR_BACKEND: VALUE

KEY

is one of:

• CAPTION[OPTIONAL] (may have more than one)
• HEADER (may have more than one)
• NAME
• PLOT
• RESULTS[OPTIONAL]

BACKEND

a string constituted of alpha-numeric characters, hyphens or underscores. May have more than one.

OPTIONAL

can contain any character but a new line; the following keys are the only ones that can contain an OPTIONAL element:

• CAPTION
• RESULTS

VALUE

can contain any character but a new line

The following types cannot be assigned attributes

• comment
• clocks
• headlines
• inlinetasks
• items
• node properties
• planning
• property drawers
• sections
• table rows