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.

lisp code navigation commands
Ctrl+Alt+backward-sexpMove to previous sibling
(move to the (beginning of) previous sexp unit)
Ctrl+Alt+forward-sexpMove to next sibling
(move to the (end of) next sexp unit)
Ctrl+Alt+backward-up-listMove to parent
(move to the (beginning of) outer paren pair)
Ctrl+Alt+down-listMove 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.

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

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:

Emacs Lisp Basics Topic

  1. Emacs Lisp Basics
  2. Overview of Text-Processing in Emacs Lisp
  3. Emacs Lisp Examples
  4. How to Evaluate Emacs Lisp Code
  5. Elisp: Documentation Lookup
  6. Elisp: Search Documentation
  7. How to Edit Lisp Code with Emacs

Working with Brackets Topic

  1. Emacs: Highlight Brackets ({[]})
  2. Emacs: Insert Brackets by Pair
  3. Emacs: Delete Parenthesis/Brackets ()[]{} by Pair
  4. Emacs: Select Line, between Quotes, Extend Selection
  5. Emacs: Move Cursor to Bracket/Quote
  6. Emacs: Change Brackets and Quotes
Like my tutorial? Put $5 at patreon

Or Buy Xah Emacs Tutorial

Or buy a nice keyboard: Best Keyboard for Emacs

Ask me question on patreon