Org-mode 简明手册

Org 是一个用文本方式来快速高效地做笔记、维持待办事项和做项目计划的模式。它是一个创作发布系统。

这个文档是 Org-mode 手册的一个压缩版本。包含了所有的基本功能和命令，以及一些重要的定制提示。本文档写给不想阅读200多页手册的新手。

重要： 如果你用的是 Emacs 或者 XEmacs 包里的 Org 版本，请跳过本节，直接阅读 1.3 节。

如果你是从网站上下载的 Org 版本，无论是 zip 包还是 tar 文件或者是 Git 文件，最好在分发包目录里直接来设置它。把 lisp 子目录加到 Emacs 的加载路径里，可以把下面两句加在 “.emacs” 文件里：
#+srcname 1₁

(setq load-path (cons "~/path/to/orgdir/lisp" load-path))
(setq load-path (cons "~/path/to/orgdir/contrib/lisp" load-path))

为了提高速度可以用下面的 shell 命令将 Lisp 文件编译一下：
#srcname 1₂
#begin_src sh

make

#end_src

再把下面一行加到 .emacs 文件里。它可以使文件中的函数自动加载，而不是启动 Org 模式时立即加载。
#+srcname 1₃

(require 'org-install)

把下面几行加到 .emacs 文件里。后三行是为命令定义全局快捷键――请改成适合你自己的。
#+srcname 1₄

;; The following lines are always needed. Choose your own keys.
(add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode))
(add-hook 'org-mode-hook 'turn-on-font-lock) ; not needed when global-font-lock-mode is on
(global-set-key "\C-cl" 'org-store-link)
(global-set-key "\C-ca" 'org-agenda)
(global-set-key "\C-cb" 'org-iswitchb)

设置之后，打开 .org 扩展的文件会自动进入 org 模式。

如果你发现了问题，或者有问题评论或新想法，可以给Org的邮件列表 emacs-orgmode@gnu.org 发邮件。了解更多信息或者提交 bug，参见手册。

Org 是在大纲模式之上实现的。大纲模式可以让我们用层次结构来组织文档，这（至少对我来说）是笔记和想法的最好实现方式。这种结构可以折叠（隐藏）文档的一部分而只显示文档的大概结构或者只显示我们正在处理的部分。Org 大大简化了大纲模式的使用，它把大纲模式的整个显示/隐藏功能整合到了一个命令中：org-cycle，这个命令绑定到了TAB键上。

标题定义了大纲树的结构。它以处于一行左边缘的一个或多个星号开头。例如：

* Top level headline
* Second level
* 3rd level
,    some text
* 3rd level
,    more text

* Another top level headline

如果你不喜欢太多的星号，可以以空格后加一个星号作为标题的开头。查看 15.2 节 [Clean view]，那里有设置方法。

大纲模式可以隐藏缓冲区里的部分正文。Org 用绑定到 TAB 和 S-TAB 上的两个全命令来改变视图。

当 Emacs 刚打开文件时，全局的状态是 OVERVIEW，也即只有顶层的标题可见。这可以通过变量 org-startup-folded 来设置。也可以通过 startup 关键字设置只对单个文件有效：
#+srcname 2₂

#+STARTUP: content

下面的命令可以跳转到缓冲区其他的标题。

如果有活动区域（暂时标记状态），提升和降低功能将会对区域中的所有标题起作用。

Org 模式的一个重要的功能是能根据大纲树中选择的信息构造出稀疏的树，这样文档就可以尽可能地折叠，但是选择的信息和它对应的标题会显示出来。试下就知道它是怎样工作的了。

Org 模式有几个命令可以创建这种树，这些命令都可以通过调度器来使用：

其他的基于 TODO 关键字、标签或属性来选择标题的稀疏树命令，我们会在本手册的后面讨论。

在大纲树的一项中，自定义格式的列表可以提供更多的组织结构，也使我们可以得到一个复先框列表（见 5.6 节［复先框］）。Org 模式可以处理这种列表，并且 HTML 导出器（见12章）也支持这种格式。

Org 能够识别有序列表、无序列表和描述列表。

• 无序列表项以‘-’、‘+’或者‘*‘开头。
  
• 有序列表项以‘1.’、‘1)’或者开头。
  
• 描述列表用‘::’将项和描述分开。
  

同一列表中的项的第一行必须缩进相同程度。当下一行的缩进与列表项的的开头的符号或者数字相同或者更小时，这一项就结束了。当所有的项都关上时，或者后面有两个空行时，列表就结束了。例如：
#+srcname 2₃

* Lord of the Rings
,   My favorite scenes are (in this order)
,   1. The attack of the Rohirrim
,   2. Eowyn's fight with the witch king
,       + this was already my favorite scene in the book
,       + I really like Miranda Otto.
,   Important actors in this film are:
,   - Elijah Wood :: He plays Frodo
,   - Sean Austin :: He plays Sam, Frodo's friend.

当光标位于一项的第一行时（带有项标志符号的行），下面的命令将会作用于该项：

脚注就是以脚注定义符号开头的一段话，脚注定义符号是将脚注名称放在一个方括号里形成的，要求放在第0列，不能有缩进。而引用就是在正文中将脚注名称用方括号括起来。例如：
#+srcname 2₄

,The Org homepage[fn:1] now looks a lot better than it used to.
,...
,[fn:1] The link is: http://orgmode.org

用下面的命令来处理脚注：

扩展阅读：
手册第 2 章
Sacha Chua's tutorial

Org 能够识别 URL 格式的文本并将它们处理成可点击的链接。通常链接格式是这样的：

[[link][description]]  或者  [[link]]

链接输入一旦完成（所有的括号都匹配），Org 就会改变它的视图。这里会看到 ”description“ 和 ”link“ ，而不是

[[link][descriptoin]]

和

[[link]]。

要想编辑链接，可以光标置于链接上并键入 C-c C-l。

如果一个链接地址并不是 URL 的形式，就会作为当前文件内部链接来处理。最重要的一个例子是

[[#my-custom-id]]

它会链接到 CUSTOM_ID 属性是 “my-custom-id” 的项。

类似

[[My Target]]

和

[[My Target][Find my target]]

的链接，点击后本文件中查找对应的目标 “<<My Target>>” 。

Org 支持的链接格式包括文件、网页、新闻组、BBDB 数据库项、IRC 会话和记录。外部链接是 URL 格式的定位器。以识别符开头，后面跟着一个冒号，冒号后面不能有空格。下面是一些例子：

,http://www.astro.uva.nl/~dominik            on the web
,file:/home/dominik/images/jupiter.jpg       file, absolute path
,/home/dominik/images/jupiter.jpg            same as above
,file:papers/last.pdf                        file, relative path
,file:projects.org                           another Org file
,docview:papers/last.pdf::NNN                open file in doc-view mode at page NNN
,id:B7423F4D-2E8A-471B-8810-C40F074717E9     Link to heading by ID
,news:comp.emacs                             Usenet link
,mailto:adent@galaxy.net                     Mail link
,vm:folder                                   VM folder link
,vm:folder#id                                VM message link
,wl:folder#id                                WANDERLUST message link
,mhe:folder#id                               MH-E message link
,rmail:folder#id                             RMAIL message link
,gnus:group#id                               Gnus article link
,bbdb:R.*Stallman                            BBDB link (with regexp)
,irc:/irc.com/#emacs/bob                     IRC link
,info:org:External%20links                   Info node link (with encoded space)

链接的括号应当是闭合的。当链接含有描述文字是显示描述文字而不是链接地址（见 4.1 节［链接格式］），例如：

[[http:www.gnu.org/software/emacs/][GNU Emacs]]

如果描述信息是一个文件名或者是指向图片的 URL。HTML 导出（见 12.4 节[HTML 导出]）时会将图片内联成一个可以点击的按钮。如果没有描述信息且链接指向一个图片，那么图片就会嵌入到导出的 HTML 文件中。

Org 提供了以下方法来创建和使用链接。

文件链接可以包含一些其他信息使得进入链接时可以到达特定的位置。比如双冒号之后的一个行号或者搜索选项。

下面是一些包含搜索定位功能的链接例子以及其说明：

, file:~/code/main.c::255                     进入到 255 行
, file:~/xx.org::My Target                    找到目标‘<<My Target>>’
, file:~/xx.org/::#my-custom-id               查找自定义 id 的项

扩展阅读：
手册第四章

当标题以 TODO 开关时它就成为了一个 TODO 项，例如：

, ***TODO Write letter to Sam Fortune

下面是一些使用 TODO 项的常用命令：

改变 TODO 的状态会触发标签改变。查看选项 org-todo-state-tags-triggers 的描述获得更多信息。

你可以用 TODO 关键字来定义不同的状态，用以处理项，比如：

(setq org-todo-keywords
      '((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))

竖直线将 TODO 关键字（还需要进一步的动作）和 DONE 状态（不需要进一步的动作）分隔开。如果你不给出竖直线，最后一个状态会作为 DONE 状态。设置之后，C-c C-t 就会将状态从 TODO 转换到 FEEDBACK，再转换到 VERIFY，最后到 DONE 和 DELEGATED。

有时你可能希望同时使用几个不同的 TODO 状态集合。例如，你可能想要一个基本的 TODO/DONE，以及一个修改 bug 的工作流程和一个隔开的状态来表示取消的项目（既还是 DONE，也不需要进一步的动作），你可以这样设置：

(setq org-todo-keywords
      '((sequence "TODO(t)" "|" "DONE(d)")
        (sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")
        (sequence "|" "CANCELED(c)")))

关键字应该各不相同，这样对于一个选项 Org 才知道该用哪个状态序列（集合）。例子中也给出了快速使用一个关键字的方法，就是在关键字后面括号中给出快捷字母——当用 C-c C-t时，会询问，让你输入一个字母。

要定义只在一个文件中有效的 TODO 关键字，可以在文件中任意地方给出下面的文本：

#+TODO: TODO(t) | DONE(d)
#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
#+TODO: | CANCELED(c)

当改变这些行中的一行后，光标停留在改变行上，用 C-c C-c 让改变生效。

当你改变一个 TODO 状态为 DONE 时，或者当你每次改变一个 TODO 项的状态时，Org 都会自动记录时间戳或者作一个记录。这是高度可配置的。可以基于每一个关键字进入设置，并且可以定位到一个文件甚至子树。怎样记录一个任务的工作时间，见 8.4 节。

完成的项目

最基本的日志功能是跟踪一个特定项目的完成。这可以这样实现：³

(setq org-log-done 'time)

这时当你将一个项目从一个 TODO（未完成）状态改变为一个完成状态时，标题下面就会插入一行 “CLOSED:[timestamp]”。如果你想和时间戳一起作一个记录，用：⁴

(setq org-log-done 'note)

这时会提示你输入一个记录（note），并将它保存在标题为“Closing Note”项目之下。

跟踪TODO状态变化

你可能想跟踪 TODO 状态的变化。可以只记录一个时间戳，也可以为变化作一个带时间戳的记录。记录会被插入到标题之后形成列表。当有很多记录之后，你可能希望将记录取出放到抽屉里。通过定制变量 org-log-into-drawer 可以实现这个功能。
对于状态记录，Org 可以实现基于每个状态关键字的设置。实现方法是在每个后的括号中指定“！”（记录时间戳）或“@”（作一个记录）。例如：

#+TODO: TODO(t) WAIT(w@/!) | DONE(d!) CANCELED(c@)

将会设置 TODO 关键字和快速访问字母，以及当一个项目设为 DONE 时，会记录时间戳，当状态变为 WAIT 或 CANCELED 时，会作一个记录。这个语法也适用于变量 org-todo-keywords。

如果你广泛地使用 Org 模式，这样你就会有大量的 TODO 项。给它们设定优先级就很有必要。可以在 TODO 项的标题中加入一些标记（cookie）来设置它们的优先级，像这样：

* TODO [#A] Write letter to Sam Fortune

Org模式支持三个优先级别：’A‘、’B‘和’C‘。’A‘是最高级别，如不指定，’B‘是默认的。优先级只在议程中有用。

很多时候将一个大的任务分成几个的易于完成的小任务是明智的。你可以通过在TODO项目下新建一个大纲树，并在子树上标记子任务来实现这个功能。为了能对已经完成的任务有个大致的了解，你可以在标题的任何地方插入‘[/]’或者‘[%]’。当每个子任务的状态变化时，或者当你在标记上按 C-c C-时，这些标记状态也会随之更新。例如：

* Organize Party [33%]
* TODO Call people [1/2]
* TODO Peter
* DONE Sarah
* TODO Buy food
* DONE Talk to neighbor

当纯文本中的项以‘[]’开头时，就会变成一个复选框。复选框不会包含在全局 TODO 列表中，所以它们很适合地将一个任务划分成几个简单的步骤。下面是一个复选框的例子：

* TODO Organize party [1/3]
,  - [-] call people [1/2]
,    - [ ] Peter
,    - [X] Sarah
,  - [X] order food
,  - [ ] think about what music to play

复选框是分层工作的。所以如果一个复选框项目如果还有子复选框，触发子复选框将会使该复选框变化以反映出一个、多个还是没有子复选框被选中。

下面是处理复选框的命令：

扩展阅读：
手册第5章
David O’Toole’s introductory tutorial
Charles Cave’s GTD setup

标签具有大纲树的继承结构。如果一个标题具有某个标签，它的所有子标题也会继承这个标签。例如，在列表

* Meeting with the French group     :work:
* Summary by Frank                 :boss:notes:
* TODO Prepare slides for him     :action:

中,尽管没有明确标出,最后一个标题会有标签“:work:”，“:boss:”，“:note:”，和“:action”。你也可以设定一个标签让所有的标题都继承，就好像标签在包含整个文件的第零级标题中指定了一样。用下面的方法⁵：

#+FILETAGS: :Peter:Boss:Secret:

在标题后可以很容易地输入标签。在冒号之后，M-TAB 可以补全标签。也有一些专门的命令用于输入标签：

Org 支持基于一个标签列表来插入标签。默认情况这个列表是动态构建的，包含了当前缓冲区中使用过的所有标签。你也可以通过变量 org-tag-alist 在全局设定一个标签的硬列表（hard list）。另外，对于某个特定文件你也可以用下面这几行设置一个默认列表：

#+TAGS: @work @home @tennisclub
#+TAGS: laptop car pc sailboat

默认 Org 模式用一个迷你缓冲区补全设施来输入标签。另外，它也实现了一个更快速，称为 快速标签选择 （ fast tag selection ）的标签选择方法。这使得你只用按一次键就可以选择或者取消一个标签。为了使它能很好地工作，需要为常用的标签赋唯一的值。你可以在你的“.emacs”文件中通过设置变量 org-tag-alist 作全局设定。例如，如果你需要在不同的文件中经常要给条目添加标签“:@home:”，这时你就可以像这样设置：

(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))

如果标签只用于当前正在处理的文件，那么你可以这样设置标签选项行：

#+TAGS: @work(w) @home(h) @tennisclub(t) laptop(l) pc(p)

一旦标签体系设置好，就可以用来收集相关联的信息到指定列表中。

这些命令都会提示输入字符串，字符串支持基本的逻辑去处。像“+boss+urgent-project1”，是搜索所有的包含标签“boss”和“urgent”但不含“project1”的项；而 “Kathy|Sally”，搜索标签包含“Kathy”或者“Sally”和项。搜索字符串的语法很丰富，支持查找TODO关键字、条目级别和属性。更详细的介绍和例子，见第 10.3.3 节。

扩展阅读
手册第 6 章
Sacha Chua’s article about tagging in Org-mode

手册第7章
Bastien Guerry’s column view tutorial

时间戳是一个具有特定格式的日期（可能带有时间和时间段）说明，例如 <2005-10-01 Tue> ， <2003-09-16 Tue 09:39> ，或者 <2003-09-16 Tue 12:00-12:30> 。
时间戳可以出现在树条目的标题和正文的任何地方。它能使条目只在特定的日期才出现在议程列表中。（见第 10.3.1 节）我们区分为：

普通时间戳；事件；约会

一个简单的时间戳只是给一个条目加上时间和日期。这跟在纸质的议程上写下约会和事件是一样的。

* Meet Peter at the movies <2006-11-01 Wed 19:15>
* Discussion on climate change <2006-11-02 Thu 20:00-22:00>

具有时间间隔的时间戳

一个时间戳可以包含一个时间间隔，表示事件不只在指定的时间发生，还在每隔一个特定的时间如 N 天（d）、周（w）、月（m）或者年（y）之后重复发生。下面的事件每周二在议程中显示：

* Pick up Sam at school <2007-05-16 Wed 12:30 +1w>

日记样式的 sexp 条目

为了能定义更复杂的时间，Org 模式支持 Emacs 日历/日记包（calendar/diary package）中的日记条目。例如：

* The nerd meeting on every 2nd Thursday of the month
,  <%%(diary-float t 4 2)>

时间/日期段

两个时间戳用‘–’连接起来就定义了一个时间段：

* Meeting in Amsterdam
,   <2004-08-23 Mon>--<2004-08-26 Thu>

非激活的时间戳

跟普通时间戳一样，但是这里是方括号而不是尖括号。这种时间戳是未激活的，它 不 会让一个条目显示在议程中。

* Gillian comes late for the fifth time [2006-11-01 Wed]

时间戳要有特定的格式，这样才能被Org模式识别。下面的命令可以用来正确地处理时间戳的格式。

当 Org 模式询问时间/日期时，能接收任何包含时间和/或日期的字符串，它能根据当前的时间日期智能地分析字符串，从而得到没有指明的信息。你也可以用弹出的日历中选择日期。想完整地了解时间/日期询问的工作方式，可以参考手册。

时间戳前面可以加一些关键字来协助计划安排。

截止期限

意义：任务（大多数情况都会是一个TODO项，当然也可以不是）应该完成的日期。

在 截止日期 ， 任务 会列在 议程 中。另外， 今天的议程 会在任务到期 orgdeadline-warning-days 天前对即将即将到期以及已经过期的任务给出提醒，直到任务被标记为 DONE。例如：

* TODO write article about the Earth for the Guide
,    The editor in charge is bbdb:Ford Prefect
,    DEADLINE: <2004-02-29 Sun>

日程安排

意义：你计划在给定的那个日期开始进行那项任务。⁶

在给定的日期标题会列在议程中。⁷另外，对于过期的日程安排会在编辑为 今天 并给出提醒，直到被标记为 DONE。也就是说，任务会自动推迟日期直到它被完成。

* TODO Call Trillian for a date on New Years Eve.
,    SCHEDULED: <2004-12-25 Sat>

有些任务需要一再重复出现。Org 模式在截止期限、计划安排和普通时间戳中用所谓的中继器来管理这种任务。在下面的例子中：

* TODO Pay the rent
,   DEADLINE: <2005-10-01 Sat +1m>

+1m 是一个中继器；上面的意思是任务有一个截止期限 <2005-10-01> ，并从这个日期开始每月都重复出现。

使用 Org 可以记录在一个工程中花在某些特定任务上的时间。

l 键可能会在时间轴（见第 10.3.4 节）和议程（见第 10.3.1 节）中使用来查看一天中处理和关闭了哪些任务。

扩展阅读
手册第 8 章
Charles Cave’s Date and Time tutorial
Bernt Hansen’s clocking workflow

Org 的获取一个新条目的方法很大程序上受 John Wiegley 的 excellent remem-ber package 的影响。它使得你可以在工作流程中中断一小会儿来存贮一个简短的笔记。Org可以为新条目定义模板，并将它们与不同的目标文件关联起来以保存笔记。

设定截取位置⁸

下面的定制为笔记设置了一个默认的目标⁹文件，并为捕获新的任务定义了一个全局快捷键¹⁰。

(setq org-default-notes-file (concat org-directory "/notes.org"))
(define-key global-map "\C-cc" 'org-capture)

截取的使用

捕获模板

用可以用不同的模板来做不同的捕获笔记，并将它们保存到不同的地方。例如，你想将新任务保存到文件“TODO.org”的“Tasks”标题下，而将日记项目保存到“journal.org”中一个时间树中。你可以：

(setq org-capture-templates
      '(("t" "Todo" entry (file+headline "~/org/gtd.org" "Tasks")
         "* TODO %?\n %i\n %a")
        ("j" "Journal" entry (file+datetree "~/org/journal.org")
         "* %?\nEntered on %U\n %i\n %a")))

其中，第一个字符串是模式的关键字，第二个字符串是简短的描述信息。接着是条目的类型和保存笔记的目标地址。最后是模板本身，它利用%作转义符基于时间和上下文来填充一些信息。

当你调用 M-x org-capture 时，Org 提示输入一个键来选择模板（如果你有多个模板），然后就会给出像这样的内容：

* TODO
 [[file:link to where you were when initiating capture]]

在扩展模板时，可以用%转义符进行动态地插入内容。下面是一些可以使用的项，查看手册获得更多的选项。¹¹

当你回顾捕获的数据时，可以想把其中的一些条目转送到另一列表中，比如说到一工程项目。剪切，查找正确的地址，然后再粘贴笔记，这就似乎有些麻烦。为了简化这个过程，可以用专门的命令：

当一个用（子）树表示的工程完成后，你可能想把它移走，不让它再在议程里显示。归档能使你的工作文件变得简洁，并能使议程视图构造等全局搜索保持高效。最常用的归档命令是将工程树移到另一个文件——归档文件。

默认的归档位置是当前文件同目录下，名为当前文件名后加 “_archive” 的文件。例子和设置位置的方法见变量 org-archivelocation 的帮助信息。下面是一个在缓冲区内设置该变量的方法：

#+ARCHIVE: %s_done::

扩展阅读
手册第9章
Charles Cave’s remember tutorial
Sebastian Rose’s tutorial for capturing from a web browser

显示的信息通常是从各个议程文件中收集来的，这样文件在变量 org-agenda-files 中列出。

视图是通过议程调试器创建的，通常我们会给它设置一个全局快捷键——比如 C-c a （见第1.2节）。按 C-c a 之后，就会提示再输入一个字母来执行对应的命令：

议程缓冲区中的条目链接到了它们的源 Org 或者日记文件。有一些命令可以用来显示和跳转到条目的源位置，也可以从视图缓冲区中”远程“编辑源文件。下面只是所有命令的一个选集，浏览 Agenda 菜单和手册获得完整的列表。

动作

查看/转到 Org 文件

改变显示方式

二级筛选和查询编辑

远程编辑（参考手册获得更多命令）

自定义搜索的主要用途是对于频繁使用的搜索进行快捷键绑定，从而快捷地创建议程缓冲区或者稀疏树（当然后者只涵盖当前缓冲区的内容）。自定义的命令是用变量 org-agenda-custom-commands 来配置的。你可以用 C-c a C 来定制这个变量。也可以直接在 ”.emacs“ 中用 Emacs lisp 来设置。下面的例子包含了所有合法的搜索类型：

(setq org-agenda-custom-commands
      '(("w" todo "WAITING")
        ("u" tags "+boss-urgent")
        ("v" tags-todo "+boss-urgent")))

每个项的首字符串是使用调度器命令 C-c a 之后要给出的键以使用相应的命令。通常都是单个字符。第二个参数是搜索类型，接着是用来进行匹配的字符串或者正则表达式。上面的例子定义了：

扩展阅读
手册第 10 章
Mat Lundin’s tutorial about custom agenda commands
John Wiegley’s setup

文档标题

导出文件的标题在特定行给出：

#+TITLE: This is the title of the document

标题和章节

第二章描述的大纲结构确定了导出文档的结构基础。然而由于大纲结构也用于（比如说）列表和任务，因此只有前三个级别用作标题。更深的级别会被看作项目列表。你可以通过变量 org-export-headline-levels 在全局设置这个开关，或者只是在单个文件中设置：

#+OPTIONS: H:4

目录表

目录表通常会直接插入在文档第一个标题之前。

#+OPTIONS: toc:2 (目录中只显示二级标题)
#+OPTIONS: toc:nil (无目录)

段落、分行和引用

段落之间至少要有一空行。如果你想实现段内分行，可以在行后加上“\\”。

要想在一个区域内实现分行，而其他地方使用正常格式，你可以使用下面的构造，它也可以用来实现诗歌的格式：

#+BEGIN_VERSE
, Great clouds overhead
, Tiny black birds rise and fall
, Snow covers Emacs

,     -- AlexSchroeder
#+END_VERSE

当从另外一个文档中引用一段话时通过会让它左右都缩进。在 Org 文档中可以这样作引用：

#+BEGIN_QUOTE
,Everything should be made as simple as possible,
,but not any simpler -- Albert Einstein
#+END_QUOTE

如果你想让某些文本居中，可以这样：

#+BEGIN_CENTER
,Everything should be made as simple as possible, \\
,but not any simpler
#+END_CENTER

强调和等宽

你可以让文字 粗体 ， 斜体 ， 下划线 ， 代码 ，以及 逐文本 ，如果必需，也可以'划掉'。代码和逐文本的字符串不会以Org模式的语法格式来处理，会被逐字输出。想要插入一个水平格尺¹⁷，用一个只含有破折号的行来实现，要求至少有5个破折号。

注释行

以‘#‘位于第 0 列的行会被看作注释，不会被导出。如果你想要一个缩进的行也被作为注释，用“#+”开头。另外以关键字 “COMMENT” 开头的子树整个树都不会被导出。最后，被 “#+BEGIN_COMMENT“ … ”#+END_COMMENT” 包围的整个区域也都不会被导出。

对于 Org 模式的表格，以竖直线开头的行会成为表格的首行。你可以在表格前面用下面几行为表格指定标题和标签，以方便交叉引用，在文本中可以用 \ref{tab:basic-data} 来引用它：

#+CAPTION: This is the caption for the next table (or link)
#+LABEL: tbl:basic-data
,   | ... | ... |
,   |-----+-----|

一些后端（HTML，LaTeX，以及 DocBook）允许直接插入图片到导出的文档中。Org 也可以，只要图片的链接不含有描述部分就行了，例如：

[[./img/a.jpg]]

如果你希望为图片定义一个标题，或者一个标签方便内部交叉引用，可以让图片单独一行，在前面加上：

#+CAPTION: This is the caption for the next figure link (or table)
#+LABEL: fig:SED-HR4049
[[./img/a.jpg]]

你也可以为图形指定一些其他的特性。但由于这与后端¹⁸密切相关，可以参考关于特定后端的章节获得详细信息。

你可以包含进来一些纯文本的例子，这不属于准备的范畴。这些例子会等宽排版，所以适用于代码以及其他类似的情况：

#+BEGIN_EXAMPLE
,Some example from a text file.
#+END_EXAMPLE

为了简单化，一些小型的例子也可以将各行以冒号开头。冒号前面可以有空格：

,Here is an example
,   : Some example from a text file.

对于一些程序设计语言的源代码以及一些其他的文本，可以被 Emacs 的字体锁（font-lock）特殊标记，你也可以让它们像在Emacs的缓冲区中那样显示：

#+BEGIN_SRC emacs-lisp
,(defun org-xor (a b)
,   "Exclusive or."
,   (if a (not b) b))
#+END_SRC

为了能在支持这种语言的专门的缓冲区中编辑例子，可以用 C-c , 启动和退出编辑缓冲区。

当导出文档时，你可以包含其他文件中的内容。比如，想包含你的“.emacs”文件，你可以用：

,      #+INCLUDE: "~/.emacs" src emacs-lisp

可选的第二个第三个参数是组织方式（例如，“quote”，“example”，或者“src”），如果是 “src”，语言用来格式化内容。组织方式是可选的，如果不给出，文本会被当作 Org 模式的正常处理。用 C-c ,可以访问包含的文件。

对于需要包含数学符号和特殊方程的科学笔记，Org 模式支持嵌入 LaTeX 代码到文件中。你可以直接使用类 TeX 的宏来输入特殊符号，输入方程，或者整个 LaTeX 环境。

,Angles are written as Greek letters \alpha, \beta and \gamma. The mass if
,the sun is M_sun = 1.989 x 10^30 kg. The radius of the sun is R_{sun} =
,6.96 x 10^8 m. If $a^2=b$ and $b=2$, then the solution must be either
,$a=+\sqrt{2}$ or $a=-\sqrt{2}$.

,\begin{equation}
,x=\sqrt{b}
,\end{equation}

特殊设置之后，导出 HTML 时 LaTeX 代码片断会生成图片并包含进来。

扩展阅读
手册第11章

导出器能识别缓冲区中提供附加信息的特殊行。这样行可以放在文件中的任何地方。整个集合可以用 C-c C-e t 插入到缓冲区中。

#+TITLE:       the title to be shown (default is the buffer name)
#+AUTHOR:      the author (default taken from user-full-name)
#+DATE:        a date, fixed, of a format string for format-time-string
#+EMAIL:       his/her email address (default from user-mail-address)
#+DESCRIPTION: the page description, e.g. for the XHTML meta tag
#+KEYWORDS:    the page keywords, e.g. for the XHTML meta tag
#+LANGUAGE:    language for HTML, e.g. ‘en’ (org-export-default-language)
#+TEXT:        Some descriptive text to be inserted at the beginning.
#+TEXT:        Several lines may be given.
#+OPTIONS:     H:2 num:t toc:t \n:nil @:t ::t |:t ^:t f:t TeX:t ...
#+LINK_UP:     the ``up'' link of an exported page
#+LINK_HOME:   the ``home'' link of an exported page
#+LATEX_HEADER: extra line(s) for the LaTeX header, like \usepackage{xyz}

所有的导出命令都可以通过导出调度器来使用，调度器是一个前缀快捷键，它会提示输入一个字母来指定命令。通常整个文件都会被导出，但是如果选中区域包含大纲树，就会导出大纲树，并以第一个标题作为文件标题。

ASCII导出功能能给 Org 文件提供的一个简单易读的版本，它只包含纯 ASCII 文本。Latin-1 和 UTF-8 导出用它们能编码的特殊字符扩展了文件的功能。

想要将 HTML 以纯文本方式复制到导出文件，可以：

#+HTML: Literal HTML code for export

或者

#+BEGIN_HTML
All lines between these markers are exported literally
#+END_HTML

默认，LaTeX输出是使用article类型。但你可以在文件中通过选项 #+LaTeX_CLASS: myclass 来改变，但类型必须是 org-export-latex-classes 中列出的。

第 11.5 节撰述的内嵌的 LaTeX 可以正确地插入到 LaTeX 文件中。跟 HTML 导出器相似，也可以通过 #+LaTeX: 和 #+BEGIN_LaTeX ... #+END_LaTeX 来加入纯文本的 LaTex 代码。

跟 HTML 导出器相似，也可以通过 #+DocBook: 和 #+BEGIN_DocBook ... #+END_DocBook 结构来加入纯文本的 DocBook 代码。²⁰

扩展阅读
手册第12章
Sebastian Rose’s image handling tutorial
Thomas Dye’s LaTeX export tutorial Eric Fraga’s BEAMER presentation tutorial

Org 支持用 M-TAB 进行缓冲区内部的补全。这种补全不需要利用 minibuffer。你只需要键入几个字母然后用快捷键在原位补全。例如，这个命令可以在‘\’后面补全 TeX 符号，在标题的开头补全 TODO 关键字，在‘:’之后补全标签。

当 Org 标题含有很多星号并且标题下面的文字不缩进时，就会显得杂乱无章。当写一个图书结构的文件时，大纲标题就是实际章节的标题，基于列表机大纲，上面的问题就不会再有，缩进的结构也会更清晰：

* Top level headline 
* Second level 
* 3rd level
,some text 
* 3rd level
,more text 
* Another top level headline

* Top level headline
,  * Second level
,    * 3rd level
,      some text
,    * 3rd level
,      more text
* Another top level headline

如果你用的 Emacs 23.1.50.3 和 Org 6.29 的更高版本，这种视图可以用 org-indent-mode 模式动态地实现，它会在每行前面加上一些前导空格。你可以通过设置变量 org-startup-indented 为所有的文件打开 org-indent-mode 模式，或者用

#+STARTUP: indent

为单个文件打开缩进。
如果你想在 Emacs 或者 Org 的早期版本中实现同样的效果，或者想让缩进用硬空格符号，以使得纯文本文件看起来一样。Org 可以缩进标题下面的文本（用TAB）;隐藏标题中的星号;只使用一级、三级等标题来为每级实现两个字符的缩进，从而实现这个功能。为了使这个特性在文件中支持，用：

#+STARTUP: hidestars odd

MobileOrg 最初是由 Richard Moreland 为 iPhone/iPod Touch 系列设备开发的应用程序。Matt Jones也为Android设备独立实现了一个版本。详见Org手册。

本文的英文原文是 Org 主页上的一篇简短手册（ The compact Org-mode Guide ）。另外：

• 本文的脚注是双向链接的，你可以大胆地查看脚注而不用担心如何再定位到原文。
  
• 我不知道如何在引用的源代码中加脚注，如果你知道，希望你能告诉我。
  
• 我不知道如果在表格中正确显示‘|’，如果你知道，希望你能告诉我。
  
• 本文可能有错误，如果发现错误（不管是什么错误），请在评论中给出。