Org-mode is Emacs' superpower. It's a note-taking tool, a task manager, a document processor, and a lifestyle. Here's everything you need to get started.
π Headings & Structure
Headings start with * (asterisks). More asterisks = deeper nesting.
* First heading
** This is a subheading for the first heading
ble ble ble bla bla
* Second heading :emacs:
** This is the second heading in the second main heading
etc etc
Pro tip: Press TAB on a heading to collapse/expand its subtree. Shift+TAB cycles the entire document.
π» Inline Formatting
Org-mode uses simple markers for text styling:
this is code
=printf("hello world");=
~Verbatim text~
=code=for inline code snippets~verbatim~for literal text (no processing)*bold*,/italic/,_underline_,+strike-through+
π Lists (Bullets & Numbers)
Lists are intuitive. Use +, -, or * for unordered lists. Numbers with . or ) for ordered lists.
* In this there are lists
+ First item
+ Second item
- Sub-item with dash
- Another sub-item
1. Numbered item
2) Also works with parentheses
3. Third item
Keybindings: M-enter = new item. M-up/down = move items. M-left/right = indent/outdent.
π Links Everywhere
Links follow the pattern: [[url][description]]
* This header have a link to duckduckgo
[[https://duckduckgo.com][Duck Duck Go website]]
* Local file link
[[file:~/Documents/notes.org][My notes]]
* Internal heading link
[[#my-heading][Jump to heading]]
Press C-c C-o (open link) while on any link to follow it. For internal links, add :CUSTOM_ID: to the heading property.
β TODO States & Task Management
Org-mode natively supports TODO keywords. Just type TODO after an asterisk.
* TODO Bla bla bla
* DONE Ble ble ble
CLOSED: [2026-05-02 21:34]
Keybindings:
S-left/rightβ cycle TODO states (TODO β DONE β back)C-c C-tβ change TODO stateC-c .β insert timestamp (like CLOSED above)
π·οΈ Tags
Tags go inside : : at the end of a heading. They're searchable!
* Tags :tags:
C-c C-c to put a tag to a header
C-c \ to search for a specific tag
Workflow:
- Type
C-c C-cwhile on a heading β Enter tag name (e.g.,emacsorurgent) - Press
C-c \β Type a tag β See only headings with that tag - Multiple tags:
:emacs:work:project:
β‘ Essential Org-mode Keybindings Cheatsheet
| Key | Action |
|---|---|
C-c C-t | Cycle TODO state |
C-c , | Set priority (A/B/C) |
C-c . | Insert timestamp |
C-c ; | Toggle comment line |
C-c C-x C-b | Show todo list |
C-c C-o | Open link |
C-c ' | Edit source block |
C-c C-c | Apply changes/refresh |
π€ Exporting to HTML (Like This Page!)
Org-mode can export to HTML, PDF, LaTeX, Markdown, and more.
C-c C-e h h β Export to HTML and open in browser
C-c C-e l p β Export to PDF (LaTeX)
C-c C-e m m β Export to Markdown
Add these to the top of your Org file for more control:
#+TITLE: My Document
#+AUTHOR: barnoun
#+DATE: 2026-05-07
#+OPTIONS: toc:nil num:nil
π― Why I Use Org-mode
- Plain text = future proof
- Git-friendly (diff works perfectly)
- I never leave Emacsβeverything is in one place
- Literate programming: code + docs mixed together
Still reading? Good. Now go open Emacs, type C-h i to read the Org-mode manual, and start organizing your entire life in plain text.