2.6 Plain Lists

Within an entry of the outline tree, hand-formatted lists can provide additional structure. They also provide a way to create lists of checkboxes (see Checkboxes). Org supports editing such lists, and every exporter (see Exporting) can parse and format them.

Org knows ordered lists, unordered lists, and description lists.

Items belonging to the same list must have the same indentation on the first line. An item ends before the next line that is indented like its bullet/number, or less. A list ends when all items are closed, or before two blank lines. An example:

* Lord of the Rings
  My favorite scenes are (in this order)
  1. The attack of the Rohirrim
  2. Eowyn's fight with the witch king
     + this was already my favorite scene in the book
     + I really like Miranda Otto.
  Important actors in this film are:
  - Elijah Wood :: He plays Frodo
  - Sean Astin :: He plays Sam, Frodo's friend.

The following commands act on items when point is in the first line of an item (the line with the bullet or number).

TAB

Items can be folded just like headline levels.

M-RET

Insert new item at current level. With a prefix argument, force a new heading (see Structure Editing).

M-S-RET

Insert a new item with a checkbox (see Checkboxes).

M-S-UP
M-S-DOWN

Move the item including subitems up/down (swap with previous/next item of same indentation). If the list is ordered, renumbering is automatic.

M-LEFT
M-RIGHT

Decrease/increase the indentation of an item, leaving children alone.

M-S-LEFT
M-S-RIGHT

Decrease/increase the indentation of the item, including subitems.

C-c C-c

If there is a checkbox (see Checkboxes) in the item line, toggle the state of the checkbox. Also verify bullets and indentation consistency in the whole list.

C-c -

Cycle the entire list level through the different itemize/enumerate bullets (‘-’, ‘+’, ‘*’, ‘1.’, ‘1)’).