org-element解析时headline的:title属性何时非字符串？如何可靠获取？

问题背景 #

我在用org-element解析Org文件时发现如下差异：

• 指定'headline参数调用org-element-parse-buffer时，能正常获取字符串格式的标题：

(org-element-map (org-element-parse-buffer 'headline) 'headline
  (lambda (a-hl)
    (message "debug:title:%s" (org-element-property :title a-hl))))

• 省略该参数时，:title属性返回的是大量sexp树形结构（类型为cons）：

(org-element-map (org-element-parse-buffer) 'headline
  (lambda (a-hl)
    (message "debug:title:%s" (org-element-property :title a-hl))))

使用hraban提供的复现代码测试：

(with-temp-buffer
  (org-mode)
  (insert "* Hello")
  (cl-flet ((say-type (prefix hl)
              (message "Headline title from %s is of type: %s"
                       prefix
                       (type-of (org-element-property :title hl)))))
    (org-element-map (org-element-parse-buffer) 'headline
      (lambda (hl) (say-type "map" hl)))
    (goto-char (point-min))
    (say-type "context" (org-element-context))
    (say-type "at-point" (org-element-at-point))))

实际输出与预期不符：

Headline title from map is of type: cons
Headline title from context is of type: string
Headline title from at-point is of type: string

一、:title属性何时不为字符串？ #

这取决于org-element-parse-buffer的解析模式：

• 当传入'headline参数时，Org Element以简化模式解析，仅提取标题的纯文本内容，因此:title属性直接是字符串。
• 省略参数时，Org Element以完整语法树模式解析，此时:title保存的是标题的完整AST（抽象语法树）结构，即cons类型的sexp，包含标题文本里的所有格式标记（如加粗、斜体、链接）和原始文本内容。

另外，org-element-context和org-element-at-point默认返回经过简化处理的元素，所以它们的:title属性为字符串。

二、如何可靠获取标题字符串？ #

不管解析模式如何，都可以通过以下两种方法稳定获取纯文本标题：

方法1：用org-element-interpret-data转换 #

该函数可将Org Element的AST结构转换为对应的纯文本字符串：

(org-element-map (org-element-parse-buffer) 'headline
  (lambda (a-hl)
    (message "debug:title:%s" (org-element-interpret-data (org-element-property :title a-hl)))))

方法2：指定解析类型为'headline #

如果仅需处理标题元素，直接在org-element-parse-buffer中传入'headline参数，强制使用简化模式解析，此时:title直接为字符串：

(org-element-map (org-element-parse-buffer 'headline) 'headline
  (lambda (a-hl)
    (message "debug:title:%s" (org-element-property :title a-hl))))

内容的提问来源于stack exchange，提问作者user10732