Documentation

Learn Macros

Everything you need to install, configure, and extend Macros. New here? Start with Getting started, then open the in-editor tutorial with C-h t.

Getting Started

Getting started

Install, first launch, the essential keys

init.scm, options, and config paths

A real, annotated evil + SPC-leader init.scm

How Macros updates and how to disable auto-updating

The default keymap and how to rebind

Discover commands from inside the editor

The interactive in-editor tutorial (C-h t)

Editing

Modal editing (evil)

Vim-style motions, operators, text objects

Modal editing (helix)

Selection-first motions, verbs, multiple selections

Editing commands

Kill/yank, region, multiple cursors, occur

The corfu-style popup and CAPFs

YASnippet-style templates with tab-stops

Code

Language servers (LSP)

Definitions, references, rename, code actions

Flycheck-style errors and navigation

Projects & search

Projectile + ripgrep find-file, grep, and perspectives

Shell & compile

compile, grep, next-error, the shell

The embedded VT/ANSI terminal

Tools

Stage, commit, branch, read diffs

Diff files and merge hunks between buffers

The directory editor / file manager

The bundled file-tree sidebar

Headings, TODOs, agenda, tables, babel

The selection / narrowing framework

Customization

Scripting with Steel

Define commands, keymaps, and modes

A SLIME-style Steel REPL in an isolated, interruptible image — eval, macroexpand, doc, apropos

Languages & modes

Tree-sitter highlighting and major modes

Install Steel extensions from git with package-install

Let an AI assistant eval Steel and read buffers in the live editor

Load themes, set faces, line numbers

Sparklines, bars, line plots, shaded function and normal-distribution plots, histograms, heatmaps

Rainbow & tree-sitter

Depth-colored brackets via tree-sitter