xheisenbugx / org.nvim

# org.nvim
### Emacs Org mode, rebuilt for Neovim in pure Lua.
Outlines · TODOs · Agenda · Capture · Clocking · Spreadsheet tables · Babel · Export
**Install** ·
**Tour** ·
**Features** ·
**Docs** ·
**Guide** ·
**Try it in your browser** ·
**Changelog** ·
**Contributing**
---
Org mode is one of the most loved tools in Emacs. It works as a
plain-text outliner, planner, time tracker, spreadsheet, literate-programming
notebook and publishing system. **org.nvim puts all of that in Neovim.** It
isn't a syntax file with a few keymaps on top. It reimplements Org's
behaviour: the agenda, capture templates, repeaters, clock tables, table
formulas, Babel and export.
- 🪶 **No dependencies.** It's about 170k lines of Lua and needs no
 tree-sitter parser, external binary or companion plugin.
- 🔁 **Works with Emacs.** It reads and writes the same plain-text format,
 so you can edit a file in Emacs today and in Neovim tomorrow.
- ⌨️ **Keys that fit Vim.** Context-aware keys fall back to normal Vim
 behaviour when they don't apply (`>>` still indents, ` ` still
 increments). Press `g?` in an org or agenda buffer to see what's
 available.
- 💤 **Ready for LazyVim.** It comes with which-key groups, a blink.cmp
 source, pickers for snacks.nvim, fzf-lua, Telescope and mini.pick, and a
 lualine clock, and it works with any other setup too.
- ✅ **Tested.** The headless test suite runs 4,800+ tests from 240+ spec
 files.
How does it compare with nvim-orgmode and Neorg? See why another Org
plugin?.
Switching from nvim-orgmode? `:h org-migrate` maps its
options and keys to org.nvim's, and `:Org migrate_config` converts your setup.
**On AI:** org.nvim is written with AI assistance
(Claude Code). To keep that honest, its
behaviour is checked against the Emacs Org source rather than guessed,
every feature comes with headless tests, and I review and use every change
myself. Bug reports are very welcome, especially where it doesn't match
Emacs.
---
## ⚡ Install in 30 seconds
With lazy.nvim / LazyVim:
 [code] 
Not using lazy.nvim? The guide covers
`vim.pack`, rocks.nvim (`:Rocks install org.nvim`), plain Vim packages, a local checkout and blink.cmp completion.
Neovim **0.11+** on Linux, macOS or Windows is all it needs; pandoc, LaTeX
and Babel's interpreters are optional (requirements).
Restart Neovim and run `:checkhealth org`. New to Org? Run `:Org tutor`:
it lists the lessons of a guided course, like `vimtutor`, each in a copy
of its own where every org key works and each exercise gets a ✓ once you
have done it (`:Org tutor basics` starts with the first; `:h org-tutor`).
Not installed yet? Try it in your browser:
the playground plays every lesson in a real Neovim, exercise by exercise,
with captions and a follow-along mode where you press the keys.
For a longer tour, `examples/tutorial.org` has
exercises for every feature and `examples/00-index.org`
a file per area; `nvim -u examples/minimal_init.lua examples/tutorial.org`
opens it without touching your config or your notes.