Emacs: Navigate Lisp Code as Tree

By Xah Lee. Date: . Last updated: .

Lisp code with its nested parenthesis syntax represents a tree structure.

Emacs has many commands that are very helpful in moving around nested brackets, analogous to navigating a tree.

backward-sexpCtrl+Alt+
Move to previous sibling. (move to the (beginning of) previous sexp unit)
forward-sexpCtrl+Alt+
Move to next sibling. (move to the (end of) next sexp unit)
backward-up-listCtrl+Alt+
Move to parent. (move to the (beginning of) outer paren pair)
down-listCtrl+Alt+
Move to first child. (move into the (beginning of) first inner paren pair)

(For historical reasons, lisp code are called “sexp”, short for Symbolic EXPression.)

The following is lisp source code laid out in a way to show its tree structure. You should try the above commands on it. It is very helpful to understand how sexp corresponds to a tree, and how the commands move the cursor exactly.

(defun
  fold
  (f x li)
  "Applies (f x ele) recursively to the list li …"
  (let
    (
      (li2 li)
      (ele)
      (x2 x)
    )
    (while
      (setq ele (pop li2))
      (setq x2 (funcall f x2 ele))
    )
    x2
  )
)

Place your cursor at the beginning of the left bracket. Now, try to move your cursor, by using ONLY Ctrl+Alt+arrow, to the “pop” , then move it to “let”, then “funcall”.

Moving to Previous/Next Sibling that Has Children

Use backward-list and forward-list to jump to prev/next sibling that has children. (i.e. skip siblings that does not have children.)

For example, suppose you have (a (b) ▮ c d (e f)) and your cursor is before “c”. Then:

Tip

In practice, navigation by tree structure is not that useful. It's much more useful to move cursor to a bracket. See Emacs: Move Cursor to Bracket 🚀

Emacs, Work with Brackets


Emacs Tutorial

Quick Start

Font

Split Window

File

Buffer

Copy/Paste

Find Replace

Unicode

Whitespace

Rectangle Edit

Line Wrap

Shell

View Special File

Editing Brackets

Org Mode

HTML

Emacs Efficiency

Misc