UP | HOME

Support via Liberapay

Org appearance

This page is about customizing the appearance of Org-mode.

Customizing Org appearance

To customize all aspects of Org appearance use

=M-x customize-group RET org-appearance RET=

Here you will find several options that can be chaged, and a further link to a page for customizing Org-mode faces.

Customize Org-mode faces

A "face" is the term emacs uses to refer to the font and colour of some text (as well as other features such as underlining etc).

Customizing Org faces is straightforward:

=M-x customize-group RET org-faces RET=

You can also customize faces on the fly by just calling the customize-face command with the cursor on the face you want to customize.

Hiding leading stars

the variable org-hide-leading-stars can be configured so that only one star is shown at the start of each heading. Many people find that this give the org buffer a cleaner appearance. This can be set in the Org Font Lock customize group as explained above in Customizing Org appearance.

Customizing the title, date, author and email lines.

The title, date and author information for an org document are specified using the special keywords #+TITLE:, #+DATE, #+AUTHOR, #+EMAIL.

By default, title, author, date and email lines appear in dark blue with the initial keywords greyed out. The title is in a larger font than the others. To change this, customize the faces

  • org-document-title
  • org-document-info
  • org-document-info-keyword

In addition, the variable org-hidden-keywords can be used to make the corresponding keywords disappear.

Using only odd outline levels

The variable org-odd-levels-only can be used so that Org only uses odd-numbered outline levels. Again, some people prefer this, finding that the Org buffer looks less cluttered.

Org-mode ready color-themes

Check out the list of color themes that are aware of org-mode.

Documentation from the orgmode.org/worg/ website (either in its HTML format or in its Org format) is licensed under the GNU Free Documentation License version 1.3 or later. The code examples and css stylesheets are licensed under the GNU General Public License v3 or later.