Global and local cycling (The Org Manual)

Next: Initial visibility, Up: Visibility Cycling [Contents][Index]

#### 2.2.1 Global and local cycling

Outlines make it possible to hide parts of the text in the buffer. Org uses just two commands, bound to `TAB` and `S-TAB` to change the visibility in the buffer.

`TAB` (`org-cycle`)

  Subtree cycling: Rotate current subtree among the states

      ,-> FOLDED -> CHILDREN -> SUBTREE --.
      '-----------------------------------'

  Point must be on a headline for this to work4.

`S-TAB` (`org-global-cycle`)
`C-u TAB`

  Global cycling: Rotate the entire buffer among the states

      ,-> OVERVIEW -> CONTENTS -> SHOW ALL --.
      '--------------------------------------'

  When `S-TAB` is called with a numeric prefix argument N, the CONTENTS view up to headlines of level N are shown. Note that inside tables (see Tables), `S-TAB` jumps to the previous field instead.

  You can run global cycling using `TAB` only if point is at the very beginning of the buffer, but not on a headline, and `org-cycle-global-at-bob` is set to a non-`nil` value.

`C-u C-u TAB` (`org-set-startup-visibility`)

  Switch back to the startup visibility of the buffer (see Initial visibility).

`C-u C-u C-u TAB` (`outline-show-all`)

  Show all, including drawers.

`C-c C-r` (`org-reveal`)

  Reveal context around point, showing the current entry, the following heading and the hierarchy above. Useful for working near a location that has been exposed by a sparse tree command (see Sparse Trees) or an agenda command (see Agenda Commands). With a prefix argument show, on each level, all sibling headings. With a double prefix argument, also show the entire subtree of the parent.

`C-c C-k` (`outline-show-branches`)

  Expose all the headings of the subtree, CONTENTS view for just one subtree.

`C-c TAB` (`outline-show-children`)

  Expose all direct children of the subtree. With a numeric prefix argument N, expose all children down to level N.

`C-c C-x b` (`org-tree-to-indirect-buffer`)

  Show the current subtree in an indirect buffer5. With a numeric prefix argument, N, go up to level N and then take that tree. If N is negative then go up that many levels. With a `C-u` prefix, do not remove the previously used indirect buffer.

`C-c C-x v` (`org-copy-visible`)

  Copy the visible text in the region into the kill ring.

#### Footnotes

### (4)

See, however, the option `org-cycle-emulate-tab`.

### (5)

The indirect buffer contains the entire buffer, but is narrowed to the current tree. Editing the indirect buffer also changes the original buffer, but without affecting visibility in that buffer. For more information about indirect buffers, see (emacs)GNU Emacs Manual.

Next: Initial visibility, Up: Visibility Cycling [Contents][Index]