Next: , Up: Exporting

12.1 The export dispatcher

The export dispatcher is the main interface for Org's exports. A hierarchical menu presents the currently configured export formats. Options are shown as easy toggle switches on the same screen.

Org also has a minimal prompt interface for the export dispatcher. When the variable org-export-dispatch-use-expert-ui is set to a non-nil value, Org prompts in the minibuffer. To switch back to the hierarchical menu, press <?>.

C-c C-e     (org-export-dispatch)

Invokes the export dispatcher interface. The options show default settings. The C-u prefix argument preserves options from the previous export, including any sub-tree selections.

Org exports the entire buffer by default. If the Org buffer has an active region, then Org exports just that region.

These are the export options, the key combinations that toggle them (see Export settings):

Toggles asynchronous export. Asynchronous export uses an external Emacs process with a specially configured initialization file to complete the exporting process in the background thereby releasing the current interface. This is particularly useful when exporting long documents.

Output from an asynchronous export is saved on the “the export stack”. To view this stack, call the export dispatcher with a double C-u prefix argument. If already in the export dispatcher menu, & displays the stack.

To make the background export process the default, customize the variable, org-export-in-background.

Toggle body-only export. Useful for excluding headers and footers in the export. Affects only those back-end formats that have such sections—like <head>...</head> in HTML.
Toggle sub-tree export. When turned on, Org exports only the sub-tree starting from the cursor position at the time the export dispatcher was invoked. Org uses the top heading of this sub-tree as the document's title. If the cursor is not on a heading, Org uses the nearest enclosing header. If the cursor is in the document preamble, Org signals an error and aborts export.

To make the sub-tree export the default, customize the variable, org-export-initial-scope.

Toggle visible-only export. Useful for exporting only visible parts of an Org document by adjusting outline visibility settings.