Thomas
Redelberger

Zur deutschen Version wechseln.

Documentation about Org Mode

EMACS org-mode is immensely powerful. However, I only use it to write documentation, especially for software and hardware development.

While learning org-mode, I wrote below lines to capture items I felt were most relevant for me, like on a cheat sheet. This might be useful to other people who have similar requirements.

To Outline the Document

Headings

One or more asterisks (stars) plus a space.

Indent/Out-Dent

M-← oder M-→

Whole sub-tree:

M-S-← oder M-S-→

Change the bullet or enumeration type or style

S-← oder S-→

This only works, when the cursor is located on the bullet character. If this is 1. oder 1) then the cursor may be at the numeral or at the . or ).

For headings this will toggle to TODO or DONE. Only headings can be TODO items.

Move a whole tree up or down

M-↑ oder M-↓

Aligning Text

The usual EMACS M-q only works correctly, when a bullet or enumeration is already properly indented.

Insert a Date

C-c ! inserts a date (more precisely: an "inactive date", that does not make it into the agenda)

On the other hand, C-c . inserts an "active date".

Inserting Special Characters

I recommend to use UTF-8 encoding in files. This is not specific to org-mode, but applies to EMACS in general. But I list it here anyway:

Any Unicode character can be inserted using

C-x 8 RET code RET

For code you could supply a hexadecimal number or a name. The name can be completed using Tab. Caveat: there are many UTF-8/Unicode characters. Hence you might want to limit the search by providing some hints to the search.

Examples:

My Description Glyph Hexadec. Name
Simple, short, thin arrow to the left 2190 LEFTWARDS ARROW
Simple, short, thin arrow up 2191 UPWARDS ARROW
Simple, short, thin arrow to the right 2192 RIGHTWARDS ARROW
Simple, short, thin arrow down 2193 DOWNWARDS ARROW
Simple, short, thin arrow to the right and to the left 2194 LEFT RIGHT ARROW
Fixed space   A0 NO-BREAK SPACE
Fixed minus 2011 NON-BREAKING HYPHEN
Soft hyphen ­ AD SOFT HYPHEN

I put the latter three onto function keys (see my init.el), so that i can insert them quickly.

View

Hierarchy

TAB to fold/unfold

S-TAB to fold/unfold the whole hierarchy

Images

To toggle between viewing the images and viewing the links:

C-c C-x C-v (also works with CUA mode, as long as nothing is selected)

or

M-x org-toggle-inline-images

Caveats

org-mode hogs keyboard shortcuts. E.g. C-TAB ‑ which I want to use to switch buffers ‑ I need to re-assign deliberately in my init.el.

My org-mode Settings (via EMACS Customize)

Compatibility with CUA-Mode

To have org-mode work with CUA-Mode, I set org‑replace‑disputed‑keys to TRUE (found this in the org-mode FAQ under "15.10.2 Packages that conflict with Org mode")

To use "Shift-Select" (which I use often) org‑support‑shift‑select has to be set.

Show Long Lines

I set org‑startup‑truncated to "off", to have long lines shown rather than only see an arrow at the end of a long line.

Show Images when Opening a File

Go to Org, Customize Group: Org Startup, Org Startup With Inline Images and set to non-nil. This writes

 '(org-startup-with-inline-images t)

to init.el

The same can be forced per file by putting

#+STARTUP: inlineimages

at the top in the file. See orgmode.org/manual/In_002dbuffer-settings.html


Last change: 2019-03-07
© 2002-2019 Dr. Thomas Redelberger redethogmx.de