• C 代表 Ctrl 键
• M 代表 Alt 键
• S 代表 Shift 键
• TAB 代表 Tab 键
• RET 代表 Enter 键
• LEFT/RIGHT/UP/DOWN 分别代表的左右上下方向键

  以上前三个按键单独按下没有意义。

• 用 - 号表示它们搭配使用的按键
• 用空格连接的一系列符号表示顺序按下符号所代表的按键

例如：

C-x 表示同时按下Ctrl和x字符键 C-S-TAB 表示同时按下Ctrl, Shift和Tab键 M-x org-mode 表示先同时按下Alt和x字符键，再键盘输入org-mode字符串 C-x C-s 表示先同时按Ctrl和x字符键，然后同时按下Ctrl和s字符键 C-c C-e h h 表示先同时按Ctrl和c字符键，然后同时按下Ctrl和e字符键，最后键盘输入hh

要实现大纲，首先要定义标题。用 emacs 新建一个 orgmode.org 文件，输入如下内容：

* 第一级标题1
** 第二级标题1
第二级标题1内容
** 第二级标题2
* 第一级标题2
第一级标题2内容

注意：

1. * 要位于每行的行首
2. * 之后要有一个空格，然后再输入标题
3. 连续几个 * 就表示是第几级大纲，最多支持 10 级。

此时看起来似乎没什么出奇的地方，只是改变了一些颜色？其真正的用处在于可以通过标题大纲操作文档，包括折叠，定位和编辑。而这些操作都通过快捷键实现，非常有效率。尤其是对大文档。

默认的大纲显示没有缩进，显得有些乱。可以用 M-x org-indent-mode切换到另一种缩进显示方式。

如果想让某个文件默认用这种方式打开，可以在文件头部增加：

#+STARTUP: indent

如果希望打开所有org文件都默认用这种方式，可以在.emacs中配置：

(setq org-startup-indented t)

注：用于字体变形的标记 " * " " / " " + " " _ " " ^ " " = " " ~ " 与其修饰的字符之间不能有空格。

Org 能够很容易地处理 ASCII 文本表格。任何以‘|’为首个非空字符的行都会被认为是表格的一部分。’|‘也是列分隔符。一个表格是下面的样子：

你可能认为要录入这样的表格很繁琐，实际上你只需要输入表头“|Name|Pone|Age”之后，按C-c RET,就可以生成整个表格的结构。类似的快捷键还有很多：

对于单个回车换行的文本，认为其属于同一个段落。在导出的时候将会转化为不换行的同一段。如果要新起一个段落，需要留出一个空行。

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

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

有序列表和无序列表都以缩进表示层级。只要对齐缩进，不管是换行还是分块都认为是处于当前列表项。

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

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.

将显示为：

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.

五条短线或以上显示为分隔线。

• 外部链接

对于符合链接规则的内容，org-mode 会自动将其视为链接，包括：文件、网页、邮箱、新闻组、BBDB 数据库项、IRC 会话和记录等。下面是一些例子：

http://www.astro.uva.nl/~dominik	on the web
	file, absolute path
/home/dominik/images/jupiter.jpg	same as above
papers/last.pdf	file, relative path
projects.html	another Org file
papers/last.pdf	open file in doc-view mode
id:B7423F4D–C40F074717E9	Link to heading by ID
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
folder#id	MH-E message link
folder#id	RMAIL message link
group#id	Gnus article link
nil	BBDB link (with regexp)
/irc.com/#emacs/bob	IRC link
org:External%20links	Info node link (with encoded space)

对于文件链接，可以用 :: 后面增加定位符的方式链接到文件的特定位置。定位符可以是行号或搜索选项。如：

除了上述的自动链接外，还可以显示指定链接，采用如下格式：

description

link

显示指定的链接可以不显示原始的 URL 而是显示对该链接的描述。 这种方式可以用相对路径链接本地文件。

对于显示指定的链接，即可以手工输入，也可以用 org-mode 提供的快捷键进行编辑：

• 内部链接

内部链接

脚注可以看作是一种特殊的内部链接，要求具有"fn:"前缀：

添加脚注链接 脚注1 定义脚注 ²

• 浏览图片

下载 iimage.el 文件，放到 Emacs 目录里，在 .emacs 里添加

;; iimage mode
(autoload 'iimage-mode "iimage" "Support Inline image minor mode." t)
(autoload 'turn-on-iimage-mode "iimage" "Turn on Inline image minor mode." t)

然后就可以用命令 M-x iimage-mode RET 在当前模式里启动 iimage 这个 minor mode（目前只能显示以文件方式链接的图片）。

在 Org-mode 中，可以对标题增加 tag 标记。标记的格式如下：

跟特留尼西特握手                    :苦差:薪水:逃不掉:

而且Org-mode的标签自动按照大纲树的结构继承。即子标题自动继承父标题的标签。比如：

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

则最后一行标题具有 work, boss, notes, action 四个标签。

如果希望文档中的所有标题都具有某些标签，只需要定义文档元数据：

#+FILETAGS: :Peter:Boss:Secret:

如果手工输入标签，在标题后设置标签，键入:后，M-Tab自动提供标签的补齐。

更方便的做法是在正文部分用 C-c C-q 或直接在标题上用 C-c C-c 创建标签，这种方式可以列出所有预定义的标签以便选取。

上面提到，除了可以输入标签外，还可以从预定义的标签中进行选择。预定义的方式有两种：

在当前文件头部定义

这种方式预定义的标签只能在当前文件中使用。使用 #+TAGS 元数据进行标记，如：

#+TAGS: { 桌面(d) 服务器(s) }  编辑器(e) 浏览器(f) 多媒体(m) 压缩(z)

每项之间必须用空格分隔，可以在括号中定义一个快捷键；花括号里的为标签组，只能选择一个

对标签定义进行修改后，要在标签定义的位置按 C-c C-c 刷新才能生效。

在配置文件中定义

上面的标签定义只能在当前文件生效，如果要在所有的 .org 文件中生效，需要在 Emacs 配置文件 .emacs 中进行定义：

(setq org-tag-alist '(
                    (:startgroup . nil)
                         ("桌面" . ?d) ("服务器" . ?s)
                    (:endgroup . nil)
                    ("编辑器" . ?e)
                    ("浏览器" . ?f) 
                    ("多媒体" . ?m)
                    ))

默认情况下，org 会动态维护一个 Tag 列表，即当前输入的标签若不在列表中，则自动加入列表以供下次补齐使用。

为了使这几种情况（默认列表、文件预设 tags，全局预设 tags）同时生效，需要在文件中增加一个空的 TAGS定义：

#+TAGS:

使用标签可以更好的管理内容。org-mode 提供了以下功能：

可以使用逻辑表达式限制条件，更准确灵活的搜索

+     和      a+b     同时有这两个标签
-     排除    a-b     有 a 但没有 b
|     或      a|b     有 a 或者有 b
&     和      a&b     同时有 a 和 b，可以用“+”替代

在查询视图中 C-c C-c 退出

具体包括：

#+TITLE:       the title to be shown (default is the buffer name)
#+AUTHOR:      the author (default taken from user-full-name)
#+DATE:        a date, an Org timestamp1, or 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 ...
#+BIND:        lisp-var lisp-val, e.g.: org-export-latex-low-levels itemize
               You need to confirm using these, or configure org-export-allow-BIND
#+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}
#+EXPORT_SELECT_TAGS:   Tags that select a tree for export
#+EXPORT_EXCLUDE_TAGS:  Tags that exclude a tree from export
#+XSLT:        the XSLT stylesheet used by DocBook exporter to generate FO file

AUTHOR

The document author (user-full-name).

CREATOR

Entity responsible for output generation (org-export-creator-string).

DATE

A date or a time-stamp1.

EMAIL

The email address (user-mail-address).

LANGUAGE

The language used for translating some strings (org-export-default-language). E.g., ‘#+LANGUAGE: fr’ will tell Org to translate File (english) into Fichier (french) in the clocktable.

SELECT_ TAGS

The tags that select a tree for export (org-export-select-tags). The default value is :export:. Within a subtree tagged with :export:, you can still exclude entries with :noexport: (see below). When headlines are selectively exported with :export: anywhere in a file, text before the first headline is ignored.

EXCLUDE_ TAGS

The tags that exclude a tree from export (org-export-exclude-tags). The default value is :noexport:. Entries with the :noexport: tag will be unconditionally excluded from the export, even if they have an :export: tag. Code blocks contained in excluded subtrees will still be executed during export even though the subtree is not exported.

TITLE

The title to be shown. You can use several such keywords for long titles.

通常在行首以“#+”开头，可以有多种用途。

• 分行区块

默认内容不换行，需要留出空行才能换行。定义了分行的区块可以实现普通换行：

#+BEGIN_VERSE
 Great clouds overhead
 Tiny black birds rise and fall
 Snow covers Emacs
     -- AlexSchroeder
#+END_VERSE

• 缩进区块

通常用于引用，与默认格式相比左右都会留出缩进：

#+BEGIN_QUOTE
  缩进区块
#+END_QUOTE

• 居中区块

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

• 代码区块

#+BEGIN_SRC ruby
  require 'redcarpet'
  md = Redcarpet.new("Hello, world.")
  puts md.to_html
#+END_SRC

• 例子

: 单行的例子以冒号开头

#+BEGIN_EXAMPLE
 多行的例子
 使用区块

#+END_EXAMPLE

• 注释

以‘#‘开头的行被看作注释，不会被导出。区块注释采用如下写法：

#+BEGIN_COMMENT
  块注释
  ...
 #+END_COMMENT

• 表格与图片

对于表格和图片，可以在前面增加标题和标签的说明，以方便交叉引用。比如在表格的前面添加：

#+CAPTION: This is the caption for the next table (or link)
#+LABEL: tbl:table1

则在需要的地方可以通过

\ref{table1}

来引用该表格。

做好准备工作后，就可以导出了。使用命令： C-c C-e 然后选择相应的格式，就可以导出对应的文件了。

Org 包含一个发布管理系统，可以配置一个由相互链接的 Org 文件组成的工程项目的自动向 HTML 转换。你也可以设置 Org，将导出的 HTML 页面和相应的附件如图片，源代 码文件等自动上传到服务器。

下面是一个例子：

(setq org-publish-project-alist
     '(("org"
        :base-directory "~/org/"
        :publishing-directory "~/public_html"
        :section-numbers nil
        :table-of-contents nil
        :style "<link rel=\"stylesheet\"
               href=\"../other/mystyle.css\"
               type=\"text/css\"/>")))

发布相关的命令：

Org 用时间戳来查看文件是否改变。上面的命令只发布修改过的文件。你可以给它们加上前缀来强制重新发布所有的文件。