17.10 Org Syntax

由 Nicolas Goaziou 最初撰写的 Org 语法正式定义参考文档可在 Worg 草案 中查看。该文档定义了 Org 核心内部概念,如 “标题(headlines)”、“章节(sections)”、“附属关键字(affiliated keywords)”、“(高级)元素” 和 “对象(objects)”,Org 文档的每一部分均归属其中一类。

在缓冲区中执行以下命令可探索 Org 缓冲区的抽象结构:

M-: (org-element-parse-buffer) <RET>

该命令输出一个列表,以抽象结构表示缓冲区内容。导出引擎依赖该列表中的信息,大多数交互命令(如结构编辑)也依赖上下文的语法含义。

执行以下命令可检查文档语法:

M-x org-lint <RET>

该命令会执行多项检查以查找常见错误,在专用缓冲区中显示错误位置、描述及可信度(可能存在误报)。可通过以下按键操作检查结果:

C-j, TAB显示问题行
RET光标跳转到问题行
g重新检查文档
h隐藏同一检查器的所有结果
i后续检查不再显示此类结果
S按光标所在列排序结果