Last reviewed
Org Mode in Doom Emacs: Commands and Keybindings
A cheat sheet for using Org mode in Doom Emacs with evil (Vim) keys. It's a companion to the general Doom Emacs keybindings reference and to my post comparing Vimwiki, Org mode, Logseq and Obsidian. New to Org syntax? Start with Org Mode for Markdown Users.
How to read the keys
SPCis the leader key.SPC mis the local leader: commands that only apply to the current file type, here Org. In insert mode, useM-SPCandM-SPC minstead.C-means Ctrl,M-means Alt (Meta),S-means Shift.C-c C-cmeans Ctrl+c, then Ctrl+c.- Keys like
zaorgjare pressed in normal mode.M-hand friends work in normal and insert mode. - If you forget anything, press
SPC mand wait: which-key pops up a menu of everything available.
I checked every binding here against my running Doom Emacs (Doom 3.0.0-pre, Emacs 30.2) with (org +roam2 +pretty +journal +dragndrop +gnuplot) enabled in init.el. If your modules differ, a few keys may be missing or different.
A few keys need extra Org flags and system tools. +dragndrop adds the screenshot and clipboard image keys, and +gnuplot adds table plotting. On Ubuntu with GNOME (Wayland) I installed:
sudo apt install gnuplot gnome-screenshot wl-clipboardDoom uses the first screenshot tool it finds out of maim, scrot and gnome-screenshot. maim and scrot only work on X11, so on a Wayland desktop make sure neither is installed, or set org-download-screenshot-method yourself. Run doom sync and restart Emacs after changing init.el.
Global keys (work from anywhere)
These live under SPC n ("notes") and SPC o ("open"), so you can use them without an Org file open.
| Keybinding | Action |
|---|---|
SPC X | Capture a note or task (org-capture) |
SPC n n | Capture (same as SPC X) |
SPC n N | Jump to where the last capture went |
SPC n a / SPC o A | Open the agenda dispatcher |
SPC o a a | Agenda (day/week view) |
SPC o a t / SPC n t | List all TODOs |
SPC o a m / SPC n m | Search by tag |
SPC o a v / SPC n v | Search text in agenda files |
SPC n f | Find a file in ~/org/ |
SPC n F | Browse the notes folder |
SPC n s | Search (grep) all notes |
SPC n S | Search headings in agenda files |
SPC n * | Search notes for the word under the cursor |
SPC n l | Store a link to the current spot (paste later with SPC m l l) |
SPC n o | Jump to the task you're clocked in on |
SPC n c | Toggle the last clock (clock back in / out) |
SPC n C | Cancel the current clock |
SPC n y | Export the current file/region to the clipboard |
Moving around and folding
| Keybinding | Action |
|---|---|
TAB | Fold/unfold the current heading |
S-TAB | Cycle the whole file: overview → contents → everything |
za | Toggle fold |
zo / zc | Open / close fold |
zO / zC | Open / close the whole subtree |
zR / zM | Open / close all folds in the file |
zr / zm | Show / hide one more level |
zn | Open the current subtree in its own buffer |
]h / [h | Next / previous heading at the same level |
gj / gk | Next / previous element (heading, list item, paragraph) |
gh / gl | Up to the parent / down into the first child |
gH | Jump to the top-level heading |
]l / [l | Next / previous link |
]c / [c | Next / previous code block |
SPC m . | Jump to a heading in this file (fuzzy search) |
SPC m / | Jump to a heading in any agenda file |
SPC m g g | Same as SPC m . |
SPC m g G | Same as SPC m / |
SPC m g c | Go to the clocked-in task |
SPC m g x | Go to the last captured item |
SPC m g r | Go to the last refile target |
SPC m , | Switch between open Org buffers |
Headings and structure
| Keybinding | Action |
|---|---|
C-RET | New item/heading below (same level) |
C-S-RET | New item/heading above |
SPC m h | Turn the line into a heading (or back) |
SPC m i | Turn the line into a list item (or back) |
M-h / M-l | Promote / demote heading (just this heading) |
M-H / M-L | Promote / demote heading with its children |
M-k / M-j | Move heading (or list item) up / down |
<< / >> | Promote / demote (evil style) |
SPC m s h / SPC m s l | Promote / demote subtree |
SPC m s k / SPC m s j | Move subtree up / down |
SPC m s d | Cut the subtree |
SPC m s n | Narrow to subtree (hide everything else) |
SPC m s N | Widen (show everything again) |
SPC m s b | Open the subtree in an indirect buffer |
SPC m s c | Clone the subtree with a time shift (good for repeating meetings) |
SPC m s s | Sparse tree: show only headings matching a search |
SPC m s S | Sort headings or list items |
SPC m s A / SPC m A | Archive the subtree |
SPC m s a | Toggle the ARCHIVE tag |
Text objects
Use these with d, c, y and v, like any Vim text object. For example, daR deletes a whole subtree and yiR copies the contents of one.
| Text object | Selects |
|---|---|
ae / ie | An Org object (link, markup, timestamp) |
aE / iE | An element (paragraph, list item, table) |
ar / ir | A greater element (whole list, drawer, block) |
aR / iR | A subtree (heading and everything under it) |
TODOs, priorities and tags
My TODO keywords are set in config.el:
(setq org-todo-keywords
'((sequence "TODO(t)" "NEXT(n)" "INPROG(i!)" "|" "DONE(d!)" "CANCELLED(c@)")))The letter in brackets is the key you press in the SPC m t menu. ! logs a timestamp when you switch to that state, and @ asks for a note (handy for "why was this cancelled?"). With org-log-into-drawer on, those notes go into a tidy :LOGBOOK: drawer.
| Keybinding | Action |
|---|---|
SPC m t | Set the TODO state from a menu |
RET (on a TODO heading) | Toggle between TODO and DONE |
C-S-l / C-S-h | Cycle to the next / previous TODO state |
S-RIGHT / S-LEFT | Same, with the arrow keys |
SPC m T | List all TODOs in agenda files |
SPC m p p | Set the priority ([#A], [#B], [#C]) |
SPC m p u / SPC m p d | Raise / lower the priority |
C-S-k / C-S-j | Raise / lower the priority (on a heading) |
SPC m q | Set tags on the heading |
SPC m x | Toggle a checkbox - [ ] |
RET (on a checkbox) | Toggle the checkbox |
SPC m # | Update [1/3] / [33%] progress cookies |
Dates, scheduling and deadlines
| Keybinding | Action |
|---|---|
SPC m d s | Schedule (when you plan to work on it) |
SPC m d d | Set a deadline (when it's due) |
SPC m d t | Insert an active timestamp <2026-11-16 Mon> (shows in the agenda) |
SPC m d T | Insert an inactive timestamp [2026-11-16 Mon] (doesn't) |
C-S-k / C-S-j (on a date) | Move the date forward / back a day |
In the date picker you can type a date, or use relative shortcuts:
| Type or press | Means |
|---|---|
. | Today |
+1d, +2w, +1m | 1 day, 2 weeks, 1 month from today |
fri / +2fri | Next Friday / Friday after next |
15 / dec 1 | The 15th of this month / December 1st |
3pm / 15:00-16:30 | Add a time / a time range |
C-h / C-l | Back / forward one day in the calendar |
C-k / C-j | Back / forward one week |
C-S-h / C-S-l | Back / forward one month |
C-S-k / C-S-j | Back / forward one year |
Repeating tasks: add a repeater after the date, like <2026-11-16 Mon +1w>. When you mark the task DONE, Org moves the date forward a week and sets it back to TODO. Use ++1w to skip missed weeks, or .+1w to repeat one week from when you finish it.
Capture
SPC X opens the capture menu. My templates (from config.el):
| Key | Template | Goes to |
|---|---|---|
t | Task: * TODO ... with a timestamp and a link to where you were | ~/org/inbox.org → Tasks |
n | Note: * ... :note: with timestamp and link | ~/org/notes.org → Notes |
j | Journal entry | ~/org/journal.org, filed under the date |
Inside the capture window:
| Keybinding | Action |
|---|---|
C-c C-c | Save the capture and close the window |
C-c C-k | Throw the capture away |
C-c C-w | Refile it somewhere else instead of the default target |
Refile and archive
Refiling moves a heading (and its children) to a different place, in this file or another one. It's how an inbox gets sorted.
| Keybinding | Action |
|---|---|
SPC m r r | Refile to any refile target |
SPC m r R | Refile, reversed (choose from all targets) |
SPC m r f | Refile to a heading in a specific file |
SPC m r l | Refile to the last location used |
SPC m r c | Refile under the currently clocked task |
SPC m r v | Refile to a heading visible in another window |
SPC m r o / SPC m r O | Refile to another window / another buffer |
SPC m A | Archive the subtree to <file>.org_archive |
Links
| Keybinding | Action |
|---|---|
SPC m l l | Insert a link (URL, file, or stored link) |
SPC m l s / SPC m n | Store a link to the current heading |
SPC m l S | Insert the last stored link |
SPC m l i | Store a link by ID (survives renames and moves) |
SPC m l c | Paste a URL from the clipboard with its page title |
SPC m l y | Copy the link at point |
SPC m l d | Remove the link, keep the text |
SPC m l t | Toggle showing the raw link syntax |
RET (on a link) | Follow the link |
Tables
Org tables align themselves as you type. Start one by typing |Name|Age| and pressing TAB, or with SPC m b c.
| Keybinding | Action |
|---|---|
TAB / S-TAB | Next / previous cell (and realign) |
RET (normal mode, on a row) | Recalculate the table's formulas |
C-l / C-h (insert mode) | Next / previous cell |
C-j / C-k (insert mode) | Next / previous row |
M-h / M-l | Move the column left / right |
M-k / M-j | Move the row up / down |
SPC m b a | Align the table |
SPC m b c | Create a table (or convert the selected region) |
SPC m b i r / SPC m b i c | Insert a row / column |
SPC m b i h | Insert a horizontal line |
SPC m b d r / SPC m b d c | Delete a row / column |
SPC m b s | Sort rows by the current column |
SPC m b e | Edit the cell in a separate window |
SPC m b f | Edit the table formulas |
SPC m b r / SPC m b R | Recalculate this table / all tables |
SPC m b p | Plot the table with gnuplot (needs +gnuplot) |
Clocking (time tracking)
| Keybinding | Action |
|---|---|
SPC m c i | Clock in on the current heading |
SPC m c I | Clock in on the last clocked task |
SPC m c o | Clock out |
SPC m c c | Cancel the clock |
SPC m c l / SPC n c | Toggle the last clock |
SPC m c g / SPC n o | Jump to the running clock |
SPC m c E | Set an effort estimate |
SPC m c e | Change the effort estimate of the running clock |
SPC m c R | Insert a clock report table |
SPC m c r | Resolve dangling clocks (after a crash or sleep) |
Properties, drawers and blocks
| Keybinding | Action |
|---|---|
SPC m o | Set a property (e.g. :CATEGORY:, :EFFORT:) |
SPC m I | Give the heading a unique :ID: |
SPC m f | Insert or jump to a footnote |
SPC m ' | Edit the code block in its own buffer, with the right language mode |
C-c ' / C-c C-c (in that buffer) | Finish editing and go back |
C-c C-, | Insert a block (src, quote, example...) |
RET (on a code block) | Run the code block (Babel) |
SPC m k / SPC m K | Remove this block's results / all results |
SPC m a a | Attach a file to the heading |
SPC m a o | Open an attachment |
SPC m a c / SPC m a p | Attach a screenshot / image from the clipboard (needs +dragndrop) |
SPC m a P | Download an image from a copied URL and attach it (needs +dragndrop) |
zi | Toggle showing images inline |
The agenda
Open it with SPC o a a (or SPC n a, then pick a view). Inside the agenda:
| Keybinding | Action |
|---|---|
j / k | Next / previous line |
C-j / C-k | Next / previous item |
RET | Open the item (replaces the agenda window) |
TAB | Open the item in another window |
C-SPC | Show the item without leaving the agenda |
[ / ] | Previous / next day or week |
. | Back to today |
gd | Go to a specific date |
gD | Change the view (day, week, month, log mode...) |
gr / gR | Refresh / refresh all agenda buffers |
t | Change the TODO state |
C-S-l / C-S-h | Next / previous TODO state |
K / J | Raise / lower the priority |
L / H | Push the date a day later / earlier |
SPC m d s / SPC m d d | Schedule / set a deadline |
SPC m q / ct | Set tags |
ce | Set effort |
SPC m r | Refile the item |
I / O | Clock in / clock out |
cg / cc | Go to the clock / cancel it |
cr | Toggle the clock report |
st / sc / sr / se | Filter by tag / category / regexp / effort |
S | Remove all filters |
m / M | Mark / unmark all |
x | Bulk action on marked items (schedule, refile, TODO...) |
dd / da | Delete / archive the item |
C | Capture from the agenda |
u | Undo |
ZZ | Close the agenda |
ZQ | Close the agenda and the Org buffers it opened |
org-roam (+roam2)
My roam notes live in ~/org/roam/. These work from anywhere under SPC n r, and from inside a roam note under SPC m m.
| Keybinding | Action |
|---|---|
SPC n r f | Find a note (or create it if it doesn't exist) |
SPC n r i | Insert a link to a note (creates it if needed) |
SPC n r n | Capture into a note |
SPC n r r | Toggle the backlinks sidebar |
SPC n r R | Open a dedicated backlinks buffer |
SPC n r a | Open a random note |
SPC n r g | Show the graph of notes |
SPC n r F | Find a note by reference (URL, citation) |
SPC n r s | Rebuild the roam database |
SPC m m r | Refile the heading into another roam note |
SPC m m o t / SPC m m o T | Add / remove a roam tag |
SPC m m o a / SPC m m o A | Add / remove an alias |
Dailies
| Keybinding | Action |
|---|---|
SPC n r d t | Go to today's daily note |
SPC n r d n / SPC n r d T | Capture into today |
SPC n r d y / SPC n r d Y | Go to / capture into yesterday |
SPC n r d m / SPC n r d M | Go to / capture into tomorrow |
SPC n r d d / SPC n r d D | Go to / capture into any date |
SPC n r d b / SPC n r d f | Previous / next daily note |
SPC n r d - | Open the dailies folder |
org-journal (+journal)
Doom puts journal files in ~/org/journal/.
| Keybinding | Action |
|---|---|
SPC n j j | New journal entry |
SPC n j J | New scheduled entry (for a future date) |
SPC n j s | Search all journal entries |
SPC m j n / SPC m j p | Next / previous entry (in a journal file) |
SPC m s s | Search the journal (in a journal file) |
SPC m s w / SPC m s m / SPC m s y | Search this week / month / year |
Export and publish
| Keybinding | Action |
|---|---|
SPC m e | Open the export menu (HTML, PDF via LaTeX, Markdown, ODT...) |
SPC n y | Export to the clipboard |
SPC n Y | Export to the clipboard as rich text (paste into email or docs) |
SPC m P f | Publish the current file |
SPC m P p / SPC m P a | Publish a project / all projects |
To export to Markdown, press SPC m e, then m m for a .md file. That makes it easy to move a note out of Org later.
Org markup quick reference
| Write | Get |
|---|---|
* Heading, ** Subheading | Headings |
*bold* | bold |
/italic/ | italic |
_underline_ | underline |
=verbatim= / ~code~ | inline code |
+strike+ | |
- item / 1. item | Lists |
- [ ] task | Checkbox |
[[https://example.com][text]] | Link |
[[file:other.org][text]] | Link to a file |
#+begin_src python ... #+end_src | Code block |
#+begin_quote ... #+end_quote | Quote |
#+title: My Note | File title |
:tag1:tag2: at the end of a heading | Tags |
Learning more
- Press
SPC h b band search "org" to see every Org binding in your current setup. SPC h fon any command name opens its docs.- The Doom Org module docs:
SPC h d mthen choose:lang org. - The Org manual
- Doom Emacs keybindings reference for everything outside Org.

