Dev In The Mountain Header
A Developer In The mountains having fun

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

  • SPC is the leader key. SPC m is the local leader: commands that only apply to the current file type, here Org. In insert mode, use M-SPC and M-SPC m instead.
  • C- means Ctrl, M- means Alt (Meta), S- means Shift. C-c C-c means Ctrl+c, then Ctrl+c.
  • Keys like za or gj are pressed in normal mode. M-h and friends work in normal and insert mode.
  • If you forget anything, press SPC m and 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:

sh
sudo apt install gnuplot gnome-screenshot wl-clipboard

Doom 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.

KeybindingAction
SPC XCapture a note or task (org-capture)
SPC n nCapture (same as SPC X)
SPC n NJump to where the last capture went
SPC n a / SPC o AOpen the agenda dispatcher
SPC o a aAgenda (day/week view)
SPC o a t / SPC n tList all TODOs
SPC o a m / SPC n mSearch by tag
SPC o a v / SPC n vSearch text in agenda files
SPC n fFind a file in ~/org/
SPC n FBrowse the notes folder
SPC n sSearch (grep) all notes
SPC n SSearch headings in agenda files
SPC n *Search notes for the word under the cursor
SPC n lStore a link to the current spot (paste later with SPC m l l)
SPC n oJump to the task you're clocked in on
SPC n cToggle the last clock (clock back in / out)
SPC n CCancel the current clock
SPC n yExport the current file/region to the clipboard

Moving around and folding

KeybindingAction
TABFold/unfold the current heading
S-TABCycle the whole file: overview → contents → everything
zaToggle fold
zo / zcOpen / close fold
zO / zCOpen / close the whole subtree
zR / zMOpen / close all folds in the file
zr / zmShow / hide one more level
znOpen the current subtree in its own buffer
]h / [hNext / previous heading at the same level
gj / gkNext / previous element (heading, list item, paragraph)
gh / glUp to the parent / down into the first child
gHJump to the top-level heading
]l / [lNext / previous link
]c / [cNext / 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 gSame as SPC m .
SPC m g GSame as SPC m /
SPC m g cGo to the clocked-in task
SPC m g xGo to the last captured item
SPC m g rGo to the last refile target
SPC m ,Switch between open Org buffers

Headings and structure

KeybindingAction
C-RETNew item/heading below (same level)
C-S-RETNew item/heading above
SPC m hTurn the line into a heading (or back)
SPC m iTurn the line into a list item (or back)
M-h / M-lPromote / demote heading (just this heading)
M-H / M-LPromote / demote heading with its children
M-k / M-jMove heading (or list item) up / down
<< / >>Promote / demote (evil style)
SPC m s h / SPC m s lPromote / demote subtree
SPC m s k / SPC m s jMove subtree up / down
SPC m s dCut the subtree
SPC m s nNarrow to subtree (hide everything else)
SPC m s NWiden (show everything again)
SPC m s bOpen the subtree in an indirect buffer
SPC m s cClone the subtree with a time shift (good for repeating meetings)
SPC m s sSparse tree: show only headings matching a search
SPC m s SSort headings or list items
SPC m s A / SPC m AArchive the subtree
SPC m s aToggle 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 objectSelects
ae / ieAn Org object (link, markup, timestamp)
aE / iEAn element (paragraph, list item, table)
ar / irA greater element (whole list, drawer, block)
aR / iRA 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.

KeybindingAction
SPC m tSet the TODO state from a menu
RET (on a TODO heading)Toggle between TODO and DONE
C-S-l / C-S-hCycle to the next / previous TODO state
S-RIGHT / S-LEFTSame, with the arrow keys
SPC m TList all TODOs in agenda files
SPC m p pSet the priority ([#A], [#B], [#C])
SPC m p u / SPC m p dRaise / lower the priority
C-S-k / C-S-jRaise / lower the priority (on a heading)
SPC m qSet tags on the heading
SPC m xToggle a checkbox - [ ]
RET (on a checkbox)Toggle the checkbox
SPC m #Update [1/3] / [33%] progress cookies

Dates, scheduling and deadlines

KeybindingAction
SPC m d sSchedule (when you plan to work on it)
SPC m d dSet a deadline (when it's due)
SPC m d tInsert an active timestamp <2026-11-16 Mon> (shows in the agenda)
SPC m d TInsert 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 pressMeans
.Today
+1d, +2w, +1m1 day, 2 weeks, 1 month from today
fri / +2friNext Friday / Friday after next
15 / dec 1The 15th of this month / December 1st
3pm / 15:00-16:30Add a time / a time range
C-h / C-lBack / forward one day in the calendar
C-k / C-jBack / forward one week
C-S-h / C-S-lBack / forward one month
C-S-k / C-S-jBack / 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):

KeyTemplateGoes to
tTask: * TODO ... with a timestamp and a link to where you were~/org/inbox.org → Tasks
nNote: * ... :note: with timestamp and link~/org/notes.org → Notes
jJournal entry~/org/journal.org, filed under the date

Inside the capture window:

KeybindingAction
C-c C-cSave the capture and close the window
C-c C-kThrow the capture away
C-c C-wRefile 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.

KeybindingAction
SPC m r rRefile to any refile target
SPC m r RRefile, reversed (choose from all targets)
SPC m r fRefile to a heading in a specific file
SPC m r lRefile to the last location used
SPC m r cRefile under the currently clocked task
SPC m r vRefile to a heading visible in another window
SPC m r o / SPC m r ORefile to another window / another buffer
SPC m AArchive the subtree to <file>.org_archive

Links

KeybindingAction
SPC m l lInsert a link (URL, file, or stored link)
SPC m l s / SPC m nStore a link to the current heading
SPC m l SInsert the last stored link
SPC m l iStore a link by ID (survives renames and moves)
SPC m l cPaste a URL from the clipboard with its page title
SPC m l yCopy the link at point
SPC m l dRemove the link, keep the text
SPC m l tToggle 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.

KeybindingAction
TAB / S-TABNext / 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-lMove the column left / right
M-k / M-jMove the row up / down
SPC m b aAlign the table
SPC m b cCreate a table (or convert the selected region)
SPC m b i r / SPC m b i cInsert a row / column
SPC m b i hInsert a horizontal line
SPC m b d r / SPC m b d cDelete a row / column
SPC m b sSort rows by the current column
SPC m b eEdit the cell in a separate window
SPC m b fEdit the table formulas
SPC m b r / SPC m b RRecalculate this table / all tables
SPC m b pPlot the table with gnuplot (needs +gnuplot)

Clocking (time tracking)

KeybindingAction
SPC m c iClock in on the current heading
SPC m c IClock in on the last clocked task
SPC m c oClock out
SPC m c cCancel the clock
SPC m c l / SPC n cToggle the last clock
SPC m c g / SPC n oJump to the running clock
SPC m c ESet an effort estimate
SPC m c eChange the effort estimate of the running clock
SPC m c RInsert a clock report table
SPC m c rResolve dangling clocks (after a crash or sleep)

Properties, drawers and blocks

KeybindingAction
SPC m oSet a property (e.g. :CATEGORY:, :EFFORT:)
SPC m IGive the heading a unique :ID:
SPC m fInsert 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 KRemove this block's results / all results
SPC m a aAttach a file to the heading
SPC m a oOpen an attachment
SPC m a c / SPC m a pAttach a screenshot / image from the clipboard (needs +dragndrop)
SPC m a PDownload an image from a copied URL and attach it (needs +dragndrop)
ziToggle showing images inline

The agenda

Open it with SPC o a a (or SPC n a, then pick a view). Inside the agenda:

KeybindingAction
j / kNext / previous line
C-j / C-kNext / previous item
RETOpen the item (replaces the agenda window)
TABOpen the item in another window
C-SPCShow the item without leaving the agenda
[ / ]Previous / next day or week
.Back to today
gdGo to a specific date
gDChange the view (day, week, month, log mode...)
gr / gRRefresh / refresh all agenda buffers
tChange the TODO state
C-S-l / C-S-hNext / previous TODO state
K / JRaise / lower the priority
L / HPush the date a day later / earlier
SPC m d s / SPC m d dSchedule / set a deadline
SPC m q / ctSet tags
ceSet effort
SPC m rRefile the item
I / OClock in / clock out
cg / ccGo to the clock / cancel it
crToggle the clock report
st / sc / sr / seFilter by tag / category / regexp / effort
SRemove all filters
m / MMark / unmark all
xBulk action on marked items (schedule, refile, TODO...)
dd / daDelete / archive the item
CCapture from the agenda
uUndo
ZZClose the agenda
ZQClose 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.

KeybindingAction
SPC n r fFind a note (or create it if it doesn't exist)
SPC n r iInsert a link to a note (creates it if needed)
SPC n r nCapture into a note
SPC n r rToggle the backlinks sidebar
SPC n r ROpen a dedicated backlinks buffer
SPC n r aOpen a random note
SPC n r gShow the graph of notes
SPC n r FFind a note by reference (URL, citation)
SPC n r sRebuild the roam database
SPC m m rRefile the heading into another roam note
SPC m m o t / SPC m m o TAdd / remove a roam tag
SPC m m o a / SPC m m o AAdd / remove an alias

Dailies

KeybindingAction
SPC n r d tGo to today's daily note
SPC n r d n / SPC n r d TCapture into today
SPC n r d y / SPC n r d YGo to / capture into yesterday
SPC n r d m / SPC n r d MGo to / capture into tomorrow
SPC n r d d / SPC n r d DGo to / capture into any date
SPC n r d b / SPC n r d fPrevious / next daily note
SPC n r d -Open the dailies folder

org-journal (+journal)

Doom puts journal files in ~/org/journal/.

KeybindingAction
SPC n j jNew journal entry
SPC n j JNew scheduled entry (for a future date)
SPC n j sSearch all journal entries
SPC m j n / SPC m j pNext / previous entry (in a journal file)
SPC m s sSearch the journal (in a journal file)
SPC m s w / SPC m s m / SPC m s ySearch this week / month / year

Export and publish

KeybindingAction
SPC m eOpen the export menu (HTML, PDF via LaTeX, Markdown, ODT...)
SPC n yExport to the clipboard
SPC n YExport to the clipboard as rich text (paste into email or docs)
SPC m P fPublish the current file
SPC m P p / SPC m P aPublish 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

WriteGet
* Heading, ** SubheadingHeadings
*bold*bold
/italic/italic
_underline_underline
=verbatim= / ~code~inline code
+strike+strike
- item / 1. itemLists
- [ ] taskCheckbox
[[https://example.com][text]]Link
[[file:other.org][text]]Link to a file
#+begin_src python ... #+end_srcCode block
#+begin_quote ... #+end_quoteQuote
#+title: My NoteFile title
:tag1:tag2: at the end of a headingTags

Learning more

  • Press SPC h b b and search "org" to see every Org binding in your current setup.
  • SPC h f on any command name opens its docs.
  • The Doom Org module docs: SPC h d m then choose :lang org.
  • The Org manual
  • Doom Emacs keybindings reference for everything outside Org.
More places to find me
Mental Health
follow me on Mastodon