================================================================================ Org-Mode Reference Card (for version 4.79) ================================================================================ ================================================================================ Getting Started ================================================================================ (add-to-list 'auto-mode-alist '("\\.org$" . org-mode)) (define-key global-map "\C-cl" 'org-store-link) [1] (define-key global-map "\C-ca" 'org-agenda) [1] For the many customization options try M-x org-customize To read the on-line documentation try M-x org-info ================================================================================ Visibility Cycling ================================================================================ rotate current subtree between states TAB rotate entire buffer between states S-TAB show the whole file C-c C-a reveal context around point C-c C-r show subtree in indirect buffer, ded. frame C-c C-k ================================================================================ Motion ================================================================================ next/previous heading C-c C-n/p next/previous heading, same level C-c C-f/b backward to higher level heading C-c C-u jump to another place in document C-c C-j previous/next plain list item S-UP/DOWN [3] ================================================================================ Structure Editing ================================================================================ insert new heading/item at current level M-RET insert new TODO entry/checkbox item M-S-RET promote current heading up one level M-LEFT demote current heading down one level M-RIGHT promote current subtree up one level M-S-LEFT demote current subtree down one level M-S-RIGHT move subtree/list item up/down M-S-UP/DOWN kill subtree C-c C-x C-w copy subtree C-c C-x M-w yank subtree C-c C-x C-y narrow buffer to current subtree C-x n s ================================================================================ Archiving ================================================================================ toggle ARCHIVE tag C-c C-x C-a force cycling of an ARCHIVEd tree C-TAB move subtree to archive file C-c C-x C-s ================================================================================ Filtering and Sparse Trees ================================================================================ show sparse tree for all matches of a regexp C-c / view TODO's in sparse tree C-c C-v global TODO list in agenda mode C-c t [1] create sparse tree with all deadlines due C-c C-w time sorted view of current org file C-c a L ================================================================================ Tables ================================================================================ -------------------------------------------------------------------------------- Creating a table -------------------------------------------------------------------------------- just start typing, e.g. |Name|Phone|Age RET |- TAB convert region to table C-c | ... separator at least 3 spaces C-3 C-c | -------------------------------------------------------------------------------- Commands available inside tables -------------------------------------------------------------------------------- The following commands work when the cursor is inside a table. Outside of tables, the same keys may have other functionality. -------------------------------------------------------------------------------- Re-aligning and field motion -------------------------------------------------------------------------------- re-align the table without moving the cursor C-c C-c re-align the table, move to next field TAB move to previous field S-TAB re-align the table, move to next row RET -------------------------------------------------------------------------------- Row and column editing -------------------------------------------------------------------------------- move the current column left M-LEFT/RIGHT kill the current column M-S-LEFT insert new column to left of cursor position M-S-RIGHT move the current row up/down M-UP/DOWN kill the current row or horizontal line M-S-UP insert new row above the current row M-S-DOWN insert hline below (C-u : above) current row C-c - sort lines in region C-c ^ -------------------------------------------------------------------------------- Regions -------------------------------------------------------------------------------- cut rectangular region C-c C-x C-w copy rectangular region C-c C-x M-w paste rectangular region C-c C-x C-y fill paragraph across selected cells C-c C-q -------------------------------------------------------------------------------- Miscellaneous -------------------------------------------------------------------------------- to limit column width to N characters, use ...| |... edit the current field in a separate window C-c ` make current field fully visible C-u TAB export as tab-separated file M-x org-table-export import tab-separated file M-x org-table-import sum numbers in current column/rectangle C-c + -------------------------------------------------------------------------------- Tables created with the table.el package -------------------------------------------------------------------------------- insert a new table.el table C-c ~ recognize existing table.el table C-c C-c convert table (Org-mode <-> table.el) C-c ~ -------------------------------------------------------------------------------- Spreadsheet -------------------------------------------------------------------------------- Formulas typed in field are executed by TAB, RET and C-c C-c. = introduces a column formula, := a field formula. Example: Add Col1 and Col2 |=$1+$2 | ... with printf format specification |=$1+$2;%.2f| ... with constants from constants.el |=$1/$c/$cm | sum from 2nd to 3rd hline |:=vsum(@II..@III)| apply current column formula | = | set and eval column formula C-c = set and eval field formula C-u C-c = re-apply all stored equations to current line C-c * re-apply all stored equations to entire table C-u C-c * iterate table to stability C-u C-u C-c * rotate calculation mark through # * ! $ C-# show line, column, formula reference C-c ? toggle coordinate grid C-c } toggle formula debugger C-c { -------------------------------------------------------------------------------- Formula Editor -------------------------------------------------------------------------------- edit formulas in separate buffer C-c ' exit and install new formulas C-c C-c exit, install, and apply new formulas C-u C-c C-c abort C-c C-q toggle reference style C-c C-r pretty-print Lisp formula TAB complete Lisp symbol M-TAB shift reference point S-cursor shift test line for column references M-up/down scroll the window showing the table M-S-up/down toggle table coordinate grid C-c } ================================================================================ Links ================================================================================ globally store link to the current location C-c l [1] insert a link (TAB completes stored links) C-c C-l insert file link with file name completion C-u C-c C-l edit (also hidden part of) link at point C-c C-l open file links in emacs C-c C-o ... force open in emacs/other window C-u C-c C-o open link at point mouse-1/2 ... force open in emacs/other window mouse-3 record a position in mark ring C-c % jump back to last followed link(s) C-c & find next link C-c C-x C-n find previous link C-c C-x C-p -------------------------------------------------------------------------------- Internal Links -------------------------------------------------------------------------------- <> target <<>> radio target [2] [[*this text]] find headline [[this text]] find target or text in buffer [[this text][description]] optional link text -------------------------------------------------------------------------------- External Links -------------------------------------------------------------------------------- file:/home/dominik/img/mars.jpg file, absolute file:papers/last.pdf file, relative file:projects.org::*that text find headline file:projects.org::find me find trgt/string http://www.astro.uva.nl/dominik on the web mailto:adent@galaxy.net Email address news:comp.emacs Usenet group bbdb:Richard Stallman BBDB person gnus:group GNUS group gnus:group#id GNUS message vm|wl|mhe|rmail:folder Mail folder vm|wl|mhe|rmail:folder#id Mail message info:emacs:Regexps Info file:node shell:ls *.org shell command elisp:(calendar) elisp form [[external link][description]] optional link text ================================================================================ Completion ================================================================================ In-buffer completion completes TODO keywords at headline start, TeX macros after `\', option keywords after `#-â', TAGS after `:', and dictionary words elsewhere. complete word at point M-TAB ================================================================================ TODO Items and Checkboxes ================================================================================ rotate the state of the current item C-c C-t select next/previous state S-LEFT/RIGHT select next/previous set C-S-LEFT/RIGHT view TODO items in a sparse tree C-c C-v view 3rd TODO keyword's sparse tree C-3 C-c C-v set the priority of the current item C-c , [ABC] remove priority cookie from current item C-c , SPC raise/lower priority of current item S-UP/DOWN [3] insert new checkbox item in plain list M-S-RET toggle checkbox(es) in region/entry/at point C-c C-x C-b toggle checkbox at point C-c C-c checkbox statistics cookies insert [/] or [%] update checkbox statistics (C-u : whole file) C-c # ================================================================================ Tags ================================================================================ set tags for current heading C-c C-c realign tags in all headings C-u C-c C-c create sparse tree with matching tags C-c \ globally (agenda) match tags at cursor C-c C-o ================================================================================ Timestamps ================================================================================ prompt for date and insert timestamp C-c . like C-c . but insert date and time format C-u C-c . like C-c . but make stamp inactive C-c ! insert DEADLINE timestamp C-c C-d insert SCHEDULED timestamp C-c C-s create sparse tree with all deadlines due C-c C-w the time between 2 dates in a time range C-c C-y change timestamp at cursor by ±1 day S-RIGHT/LEFT [3] change year/month/day at cursor by ±1 S-UP/DOWN [3] access the calendar for the current date C-c > insert timestamp matching date in calendar C-c < access agenda for current date C-c C-o select date while prompted mouse-1/RET toggle custom format display for dates/times C-c C-x C-t -------------------------------------------------------------------------------- Clocking time -------------------------------------------------------------------------------- start clock on current item C-c C-x C-i stop clock on current item C-c C-x C-o cancel current clock C-c C-x C-x display total subtree times C-c C-x C-d remove displayed times C-c C-c insert/update table with clock report C-c C-x C-r ================================================================================ LaTeX and cdlatex-mode ================================================================================ preview LaTeX fragment C-c C-x C-l expand abbreviation (cdlatex-mode) TAB insert/modify math symbol (cdlatex-mode) ` / ' ================================================================================ Agenda Views ================================================================================ add/move current file to front of agenda C-c [ remove current file from your agenda C-c ] cycle through agenda file list C-' compile agenda for the current week C-c a a [1] compile global TODO list C-c a t [1] compile TODO list for specific keyword C-c a T [1] match tags in agenda files C-c a m [1] match tags in TODO entries C-c a M [1] find stuck projects C-c a # [1] show timeline of current org file C-c a L [1] configure custom commands C-c a C [1] configure stuck projects C-c a ! [1] agenda for date at cursor C-c C-o To set categories, add lines like [2]: #+CATEGORY: MyCateg -------------------------------------------------------------------------------- Commands available in an agenda buffer -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- View Org file -------------------------------------------------------------------------------- show original location of item SPC/mouse-3 show and recenter window L goto original location in other window TAB/mouse-2 goto original location, delete other windows RET show subtree in indirect buffer, ded. frame b toggle follow-mode f -------------------------------------------------------------------------------- Change display -------------------------------------------------------------------------------- delete other windows o switch to daily / weekly view d / w toggle inclusion of diary entries D toggle time grid for daily schedule g toggle display of logbook entries l refresh agenda buffer with any changes r save all org-mode buffers s display the following org-agenda-ndays RIGHT display the previous org-agenda-ndays LEFT goto today . -------------------------------------------------------------------------------- Remote editing -------------------------------------------------------------------------------- digit argument 0-9 change state of current TODO item t kill item and source C-k archive the subtree $ show tags of current headline T set tags for current headline : toggle ARCHIVE tag a set priority of current item p raise/lower priority of current item S-UP/DOWN [3] display weighted priority of current item P schedule/set deadline for this item C-c C-s/d change timestamp to one day earlier/later S-LEFT/RIGHT [3] change timestamp to today > insert new entry into diary i start the clock on current item (clock-in) I stop the clock (clock-out) O cancel current clock X -------------------------------------------------------------------------------- Misc -------------------------------------------------------------------------------- Open link in current line C-c C-o -------------------------------------------------------------------------------- Calendar commands -------------------------------------------------------------------------------- find agenda cursor date in calendar c compute agenda for calendar cursor date c show phases of the moon M show sunrise/sunset times S show holidays H convert date to other calendars C -------------------------------------------------------------------------------- Quit and Exit -------------------------------------------------------------------------------- quit agenda, remove agenda buffer q exit agenda, remove all agenda buffers x ================================================================================ Calendar and Diary Integration ================================================================================ Include Emacs diary entries into Org-mode agenda with: (setq org-agenda-include-diary t) ================================================================================ Exporting and Publishing ================================================================================ Exporting creates files with extensions .txt and .html in the current directory. Publishing puts the resulting file into some other place. export/publish dispatcher C-c C-e export visible part only C-c C-e v insert template of export options C-c C-x t toggle fixed width for entry or region C-c : -------------------------------------------------------------------------------- HTML formatting -------------------------------------------------------------------------------- make words bold *bold* make words italic /italic/ make words underlined _underlined_ sub- and superscripts x^3, J_dust TeX-like macros \alpha, \to typeset lines in fixed width font start with : tables are exported as HTML tables start with | links become HTML links http:... etc include html tags @...@ -------------------------------------------------------------------------------- Comments: Text not being exported -------------------------------------------------------------------------------- Text before the first headline is not considered part of the document and is therefore never exported. Lines starting with # are comments and are not exported. Subtrees whose header starts with COMMENT are never exported. toggle COMMENT keyword on entry C-c ; ================================================================================ Dynamic Blocks ================================================================================ update dynamic block at point C-c C-x C-u update all dynamic blocks C-u C-c C-x C-u ================================================================================ Notes ================================================================================ [1] This is only a suggestion for a binding of this command. Choose you own key as shown under INSTALLATION. [2] After changing a #+KEYWORD or <<>> line, press C-c C-c with the cursor still in the line to update. [3] Keybinding affected by org-CUA-compatibility.