由 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 | 按光标所在列排序结果 |