17.1 Completion

Org has in-buffer completions. Unlike minibuffer completions, which are useful for quick command interactions, Org’s in-buffer completions are more suitable for content creation in Org documents. Type one or more letters and invoke the hot key to complete the text in-place. Depending on the context and the keys, Org offers different types of completions. No minibuffer is involved. Such mode-specific hot keys have become an integral part of Emacs and Org provides several shortcuts.

M-TAB

Complete word at point.

  • At the beginning of an empty headline, complete TODO keywords.
  • After ‘\’, complete TeX symbols supported by the exporter.
  • After ‘:’ in a headline, complete tags. Org deduces the list of tags from the ‘TAGS’ in-buffer option (see Setting Tags), the variable org-tag-alist, or from all tags used in the current buffer.
  • After ‘:’ and not in a headline, complete property keys. The list of keys is constructed dynamically from all keys used in the current buffer.
  • After ‘[[’, complete link abbreviations (see Link Abbreviations).
  • After ‘[[*’, complete headlines in the current buffer so that they can be used in search links like: ‘[[*find this headline]]
  • After ‘#+’, complete the special keywords like ‘TYP_TODO’ or file-specific ‘OPTIONS’. After option keyword is complete, pressing M-TAB again inserts example settings for this keyword.
  • After ‘STARTUP’ keyword, complete startup items.
  • When point is anywhere else, complete dictionary words using Ispell.