doc/orgcard.txt

   1 ================================================================================
   2 Org-Mode Reference Card (for version 6.06)
   3 ================================================================================
   4
   5 ================================================================================
   6 Getting Started
   7 ================================================================================
   8
   9 (add-to-list 'auto-mode-alist '("\\.org$" . org-mode))
  10 (define-key global-map "\C-cl" 'org-store-link) [1]
  11 (define-key global-map "\C-ca" 'org-agenda) [1]
  12
  13 For the many customization options try            M-x org-customize
  14 To read the on-line documentation try             M-x org-info
  15
  16 ================================================================================
  17 Visibility Cycling
  18 ================================================================================
  19
  20 rotate current subtree between states             TAB
  21 rotate entire buffer between states               S-TAB
  22 show the whole file                               C-c C-a
  23 reveal context around point                       C-c C-r
  24 show subtree in indirect buffer, ded. frame       C-c C-k
  25
  26 ================================================================================
  27 Motion
  28 ================================================================================
  29
  30 next/previous heading                             C-c C-n/p
  31 next/previous heading, same level                 C-c C-f/b
  32 backward to higher level heading                  C-c C-u
  33 jump to another place in document                 C-c C-j
  34 previous/next plain list item                     S-UP/DOWN [3]
  35
  36 ================================================================================
  37 Structure Editing
  38 ================================================================================
  39
  40 insert new heading/item at current level          M-RET
  41 insert new heading after subtree                  C-RET
  42 insert new TODO entry/checkbox item               M-S-RET
  43 promote/demote current heading up one level       M-LEFT/RIGHT
  44 promote/demote current subtree up one level       M-S-LEFT/RIGHT
  45 move subtree/list item up/down                    M-S-UP/DOWN
  46 refile subtree                                    C-c C-w
  47 kill subtree                                      C-c C-x C-w
  48 copy subtree                                      C-c C-x M-w
  49 yank subtree                                      C-c C-x C-y
  50 narrow buffer to current subtree                  C-x n s
  51 widen restriction to full buffer                  C-x n w
  52
  53 ================================================================================
  54 Archiving
  55 ================================================================================
  56
  57 toggle ARCHIVE tag                                C-c C-x C-a
  58 force cycling of an ARCHIVEd tree                 C-TAB
  59 move subtree to archive file                      C-c C-x C-s
  60
  61 ================================================================================
  62 Filtering and Sparse Trees
  63 ================================================================================
  64
  65 construct a sparse tree by various criteria       C-c /
  66 view TODO's in sparse tree                        C-c C-v
  67 global TODO list in agenda mode                   C-c a t [1]
  68 time sorted view of current org file              C-c a L
  69
  70 ================================================================================
  71 Tables
  72 ================================================================================
  73
  74 --------------------------------------------------------------------------------
  75 Creating a table
  76 --------------------------------------------------------------------------------
  77
  78 just start typing, e.g.                           |Name|Phone|Age RET |- TAB
  79 convert region to table                           C-c |
  80 ... separator at least 3 spaces                   C-3 C-c |
  81
  82 --------------------------------------------------------------------------------
  83 Commands available inside tables
  84 --------------------------------------------------------------------------------
  85
  86 The following commands work when the cursor is inside a table.  Outside of
  87 tables, the same keys may have other functionality.
  88
  89 --------------------------------------------------------------------------------
  90 Re-aligning and field motion
  91 --------------------------------------------------------------------------------
  92
  93 re-align the table without moving the cursor      C-c C-c
  94 re-align the table, move to next field            TAB
  95 move to previous field                            S-TAB
  96 re-align the table, move to next row              RET
  97
  98 --------------------------------------------------------------------------------
  99 Row and column editing
 100 --------------------------------------------------------------------------------
 101
 102 move the current column left                      M-LEFT/RIGHT
 103 kill the current column                           M-S-LEFT
 104 insert new column to left of cursor position      M-S-RIGHT
 105 move the current row up/down                      M-UP/DOWN
 106 kill the current row or horizontal line           M-S-UP
 107 insert new row above the current row              M-S-DOWN
 108 insert hline below (C-u : above) current row      C-c -
 109 sort lines in region                              C-c ^
 110
 111 --------------------------------------------------------------------------------
 112 Regions
 113 --------------------------------------------------------------------------------
 114
 115 cut rectangular region                            C-c C-x C-w
 116 copy rectangular region                           C-c C-x M-w
 117 paste rectangular region                          C-c C-x C-y
 118 fill paragraph across selected cells              C-c C-q
 119
 120 --------------------------------------------------------------------------------
 121 Miscellaneous
 122 --------------------------------------------------------------------------------
 123
 124 to limit column width to N characters, use        ...| <N> |...
 125 edit the current field in a separate window       C-c `
 126 make current field fully visible                  C-u TAB
 127 export as tab-separated file                      M-x org-table-export
 128 import tab-separated file                         M-x org-table-import
 129 sum numbers in current column/rectangle           C-c +
 130
 131 --------------------------------------------------------------------------------
 132 Tables created with the table.el package
 133 --------------------------------------------------------------------------------
 134
 135 insert a new table.el table                       C-c ~
 136 recognize existing table.el table                 C-c C-c
 137 convert table (Org-mode <-> table.el)             C-c ~
 138
 139 --------------------------------------------------------------------------------
 140 Spreadsheet
 141 --------------------------------------------------------------------------------
 142
 143 Formulas typed in field are executed by TAB, RET and C-c C-c.  = introduces a
 144 column formula, := a field formula.
 145
 146 Example: Add Col1 and Col2                        |=$1+$2 |
 147 ... with printf format specification              |=$1+$2;%.2f|
 148 ... with constants from constants.el              |=$1/$c/$cm |
 149 sum from 2nd to 3rd hline                         |:=vsum(@II..@III)|
 150 apply current column formula                      | = |
 151 set and eval column formula                       C-c =
 152 set and eval field formula                        C-u C-c =
 153 re-apply all stored equations to current line     C-c *
 154 re-apply all stored equations to entire table     C-u C-c *
 155 iterate table to stability                        C-u C-u C-c *
 156 rotate calculation mark through # * ! $           C-#
 157 show line, column, formula reference              C-c ?
 158 toggle coordinate grid                            C-c }
 159 toggle formula debugger                           C-c {
 160
 161 --------------------------------------------------------------------------------
 162 Formula Editor
 163 --------------------------------------------------------------------------------
 164
 165 edit formulas in separate buffer                  C-c '
 166 exit and install new formulas                     C-c C-c
 167 exit, install, and apply new formulas             C-u C-c C-c
 168 abort                                             C-c C-q
 169 toggle reference style                            C-c C-r
 170 pretty-print Lisp formula                         TAB
 171 complete Lisp symbol                              M-TAB
 172 shift reference point                             S-cursor
 173 shift test line for column references             M-up/down
 174 scroll the window showing the table               M-S-up/down
 175 toggle table coordinate grid                      C-c }
 176
 177 ================================================================================
 178 Links
 179 ================================================================================
 180
 181 globally store link to the current location       C-c l [1]
 182 insert a link (TAB completes stored links)        C-c C-l
 183 insert file link with file name completion        C-u C-c C-l
 184 edit (also hidden part of) link at point          C-c C-l
 185 open file links in emacs                          C-c C-o
 186 ... force open in emacs/other window              C-u C-c C-o
 187 open link at point                                mouse-1/2
 188 ... force open in emacs/other window              mouse-3
 189 record a position in mark ring                    C-c %
 190 jump back to last followed link(s)                C-c &
 191 find next link                                    C-c C-x C-n
 192 find previous link                                C-c C-x C-p
 193 edit code snippet of file at point                C-c '
 194
 195 --------------------------------------------------------------------------------
 196 Internal Links
 197 --------------------------------------------------------------------------------
 198
 199 <<My Target>>                                     target
 200 <<<My Target>>>                                   radio target [2]
 201 [[*this text]]                                    find headline
 202 [[this text]]                                     find target or text in buffer
 203 [[this text][description]]                        optional link text
 204
 205 --------------------------------------------------------------------------------
 206 External Links
 207 --------------------------------------------------------------------------------
 208
 209 file:/home/dominik/img/mars.jpg                   file, absolute
 210 file:papers/last.pdf                              file, relative
 211 file:projects.org::*that text                     find headline
 212 file:projects.org::find me                        find trgt/string
 213 http://www.astro.uva.nl/dominik                   on the web
 214 mailto:adent@galaxy.net                           Email address
 215 news:comp.emacs                                   Usenet group
 216 bbdb:Richard Stallman                             BBDB person
 217 gnus:group                                        GNUS group
 218 gnus:group#id                                     GNUS message
 219 vm|wl|mhe|rmail:folder                            Mail folder
 220 vm|wl|mhe|rmail:folder#id                         Mail message
 221 info:emacs:Regexps                                Info file:node
 222 shell:ls *.org                                    shell command
 223 elisp:(calendar)                                  elisp form
 224 [[external link][description]]                    optional link text
 225
 226 ================================================================================
 227 Completion
 228 ================================================================================
 229
 230 In-buffer completion completes TODO keywords at headline start, TeX macros
 231 after `\', option keywords after `#-â', TAGS after `:', and dictionary words
 232 elsewhere.
 233
 234 complete word at point                            M-TAB
 235
 236 ================================================================================
 237 TODO Items and Checkboxes
 238 ================================================================================
 239
 240 rotate the state of the current item              C-c C-t
 241 select next/previous state                        S-LEFT/RIGHT
 242 select next/previous set                          C-S-LEFT/RIGHT
 243 view TODO items in a sparse tree                  C-c C-v
 244 view 3rd TODO keyword's sparse tree               C-3 C-c C-v
 245 set the priority of the current item              C-c , [ABC]
 246 remove priority cookie from current item          C-c , SPC
 247 raise/lower priority of current item              S-UP/DOWN [3]
 248 insert new checkbox item in plain list            M-S-RET
 249 toggle checkbox(es) in region/entry/at point      C-c C-x C-b
 250 toggle checkbox at point                          C-c C-c
 251 checkbox statistics cookies                       insert [/] or [%]
 252 update checkbox statistics (C-u : whole file)     C-c #
 253
 254 ================================================================================
 255 Tags
 256 ================================================================================
 257
 258 set tags for current heading                      C-c C-c
 259 realign tags in all headings                      C-u C-c C-c
 260 create sparse tree with matching tags             C-c \
 261 globally (agenda) match tags at cursor            C-c C-o
 262
 263 \section{Properties and Column View}
 264
 265 \key{set property}{C-c C-x p}
 266 \key{special commands in property lines}{C-c C-c}
 267 \key{next/previous allowed value}{S-left/right}
 268 \key{turn on column view}{C-c C-x C-c}
 269 \key{capture columns view in dynamic block}{C-c C-x r}
 270
 271 \key{quit column view}{q}
 272 \key{next/previous allowed value}{S-left/right}
 273 \key{next/previous allowed value}{n / p}
 274 \key{edit value}{e}
 275 \key{edit allowed values list}{a}
 276 \key{show value}{v}
 277 \key{make column wider/narrower}{> / <}
 278 \key{move column left/right}{M-left/right}
 279 \key{add new column}{M-S-right}
 280 \key{Delete current column}{M-S-left}
 281
 282
 283
 284 ================================================================================
 285 Timestamps
 286 ================================================================================
 287
 288 prompt for date and insert timestamp              C-c .
 289 like C-c . but insert date and time format        C-u C-c .
 290 like C-c . but make stamp inactive                C-c !
 291 insert DEADLINE timestamp                         C-c C-d
 292 insert SCHEDULED timestamp                        C-c C-s
 293 create sparse tree with all deadlines due         C-c C-w
 294 the time between 2 dates in a time range          C-c C-y
 295 change timestamp at cursor by ±1 day              S-RIGHT/LEFT [3]
 296 change year/month/day at cursor by ±1             S-UP/DOWN [3]
 297 access the calendar for the current date          C-c >
 298 insert timestamp matching date in calendar        C-c <
 299 access agenda for current date                    C-c C-o
 300 select date while prompted                        mouse-1/RET
 301 toggle custom format display for dates/times      C-c C-x C-t
 302
 303 --------------------------------------------------------------------------------
 304 Clocking time
 305 --------------------------------------------------------------------------------
 306
 307 start clock on current item                       C-c C-x C-i
 308 stop clock on current item                        C-c C-x C-o
 309 cancel current clock                              C-c C-x C-x
 310 display total subtree times                       C-c C-x C-d
 311 remove displayed times                            C-c C-c
 312 insert/update table with clock report             C-c C-x C-r
 313
 314 ================================================================================
 315 Agenda Views
 316 ================================================================================
 317
 318 add/move current file to front of agenda          C-c [
 319 remove current file from your agenda              C-c ]
 320 cycle through agenda file list                    C-'
 321 compile agenda for the current week               C-c a a [1]
 322 compile global TODO list                          C-c a t [1]
 323 compile TODO list for specific keyword            C-c a T [1]
 324 match tags, todo kwds and properties              C-c a m [1]
 325 match only in TODO entries                        C-c a M [1]
 326 find stuck projects                               C-c a # [1]
 327 show timeline of current org file                 C-c a L [1]
 328 configure custom commands                         C-c a C [1]
 329 configure stuck projects                          C-c a ! [1]
 330 agenda for date at cursor                         C-c C-o
 331
 332 To set categories, add lines like [2]:
 333 #+CATEGORY: MyCateg
 334
 335 --------------------------------------------------------------------------------
 336 Commands available in an agenda buffer
 337 --------------------------------------------------------------------------------
 338
 339 --------------------------------------------------------------------------------
 340 View Org file
 341 --------------------------------------------------------------------------------
 342
 343 show original location of item                    SPC/mouse-3
 344 show and recenter window                          L
 345 goto original location in other window            TAB/mouse-2
 346 goto original location, delete other windows      RET
 347 show subtree in indirect buffer, ded. frame       b
 348 toggle follow-mode                                f
 349
 350 --------------------------------------------------------------------------------
 351 Change display
 352 --------------------------------------------------------------------------------
 353
 354 delete other windows                              o
 355 switch to day/week/month/year view                d/w/m/y
 356 toggle inclusion of diary entries                 D
 357 toggle time grid for daily schedule               G
 358 toggle display of logbook entries                 l
 359 toggle inclusion of archived trees/files          v / C-u v}
 360 refresh agenda buffer with any changes            r / g
 361 save all org-mode buffers                         s
 362 display the next/previous day, week,...           RIGHT/LEFT
 363 goto today                                        .
 364
 365 --------------------------------------------------------------------------------
 366 Remote editing
 367 --------------------------------------------------------------------------------
 368
 369 digit argument                                    0-9
 370 change state of current TODO item                 t
 371 kill item and source                              C-k
 372 archive the subtree                               $ / a / A
 373 show tags of current headline                     T
 374 set tags for current headline                     :
 375 toggle ARCHIVE tag                                a
 376 set priority of current item                      p
 377 raise/lower priority of current item              S-UP/DOWN [3]
 378 display weighted priority of current item         P
 379 schedule/set deadline for this item               C-c C-s/d
 380 change timestamp to one day earlier/later         S-LEFT/RIGHT [3]
 381 change timestamp to today                         >
 382 insert new entry into diary                       i
 383 start/stop/cancel the clock in current item       I / O / X
 384 jump to running clock entry                       J
 385
 386
 387 --------------------------------------------------------------------------------
 388 Misc
 389 --------------------------------------------------------------------------------
 390
 391 Open link in current line                         C-c C-o
 392
 393 --------------------------------------------------------------------------------
 394 Calendar commands
 395 --------------------------------------------------------------------------------
 396
 397 find agenda cursor date in calendar               c
 398 compute agenda for calendar cursor date           c
 399 show phases of the moon                           M
 400 show sunrise/sunset times                         S
 401 show holidays                                     H
 402 convert date to other calendars                   C
 403
 404 --------------------------------------------------------------------------------
 405 Quit and Exit
 406 --------------------------------------------------------------------------------
 407
 408 quit agenda, remove agenda buffer                 q
 409 exit agenda, remove all agenda buffers            x
 410
 411 ================================================================================
 412 Calendar and Diary Integration
 413 ================================================================================
 414
 415 Include Emacs diary entries into Org-mode agenda with:
 416 (setq org-agenda-include-diary t)
 417
 418 ================================================================================
 419 LaTeX and cdlatex-mode
 420 ================================================================================
 421
 422 preview LaTeX fragment                            C-c C-x C-l
 423 expand abbreviation (cdlatex-mode)                TAB
 424 insert/modify math symbol (cdlatex-mode)          ` / '
 425
 426 ================================================================================
 427 Exporting and Publishing
 428 ================================================================================
 429
 430 Exporting creates files with extensions .txt and .html in the current
 431 directory.  Publishing puts the resulting file into some other place.
 432
 433 export/publish dispatcher                         C-c C-e
 434 export visible part only                          C-c C-e v
 435 insert template of export options                 C-c C-x t
 436 toggle fixed width for entry or region            C-c :
 437
 438 --------------------------------------------------------------------------------
 439 Comments: Text not being exported
 440 --------------------------------------------------------------------------------
 441
 442 Text before the first headline is not considered part of the document and is
 443 therefore never exported.  Lines starting with # are comments and are not
 444 exported.  Subtrees whose header starts with COMMENT are never exported.
 445
 446 toggle COMMENT keyword on entry                   C-c ;
 447
 448 ================================================================================
 449 Dynamic Blocks
 450 ================================================================================
 451
 452 update dynamic block at point                     C-c C-x C-u
 453 update all dynamic blocks                         C-u C-c C-x C-u
 454
 455 ================================================================================
 456 Notes
 457 ================================================================================
 458
 459 [1] This is only a suggestion for a binding of this command.  Choose you own
 460 key as shown under INSTALLATION.
 461
 462 [2] After changing a #+KEYWORD or <<<target>>> line, press C-c C-c with the
 463 cursor still in the line to update.
 464
 465 [3] Keybinding affected by org-CUA-compatibility.