是否支持自定义Pandoc Writer的元素输出格式？

Pandoc完全提供官方支持的修改路径，无需修改核心源码即可实现自定义输出需求。流程机制也和补充说明的判断一致：大部分格式规则的核心决策在AST生成阶段完成，Writer层仅负责最终的格式渲染。

底层处理逻辑 #

Pandoc处理文档的固定流程为：

1. 读入reStructuredText源文件，将所有内容解析为内部抽象语法树（AST）节点
2. 运行可选的自定义过滤器，对AST节点做增、删、改操作
3. 调用对应格式的Writer，将最终的AST节点按照内置映射规则转成目标格式的内容

你提到的默认HTML输出，本质就是内置Writer对AST节点的默认映射结果：

• reStructuredText的.. topic::指令被解析为带topic类的Div节点
• 指令后的标题文本被解析为段落内的Strong节点
• 后续的正文内容被解析为普通段落节点

Writer本身不负责判断内容应该使用什么标签，仅按节点类型做固定映射：比如Div节点永远映射为<div>，Strong节点永远映射为<strong>，Mark节点才会映射为<mark>。

两种官方实现方案 #

1. Lua 过滤器（支持所有自定义需求，官方主推扩展方式） #

这是Pandoc内置的扩展机制，运行时通过内置Lua解释器遍历AST节点，直接匹配、修改节点的属性和类型，可以实现提到的全部自定义效果：

• 匹配所有带topic类的Div块，在类列表中追加自定义类名，最终输出的div就会带上额外的class属性
• 遍历topic块内的标题段落，将段落中的Strong节点替换为Mark节点，Writer渲染时就会自动输出<mark>标签代替原来的<strong>标签

可直接使用的示例过滤器代码：

function Div(el)
  -- 匹配所有带topic类的Div块
  if el.classes:includes("topic") then
    -- 给div追加自定义类
    el.classes:insert("note-card")
    -- 定位块内第一个子段落（即主题标题段）
    local title_para = el.content[1]
    if title_para.t == "Para" then
      local new_para_content = {}
      for _, inline_node in ipairs(title_para.content) do
        -- 把段内的粗体节点替换为标记节点
        if inline_node.t == "Strong" then
          table.insert(new_para_content, pandoc.Mark(inline_node.content))
        else
          table.insert(new_para_content, inline_node)
        end
      end
      title_para.content = new_para_content
    end
    return el
  end
end

运行时只需要在pandoc命令中添加--lua-filter=上述过滤器文件路径参数即可生效，完全走官方支持的命令行参数，无额外依赖。

2. 自定义HTML模板（仅适合简单的外层结构调整） #

Pandoc允许用户导出默认的HTML渲染模板，替换内置模板来调整页面整体结构，但该方案存在明显局限性：

• 模板仅能调整页面全局的包裹结构、公共元数据的输出位置，无法修改Writer对单个节点的标签映射规则
• 无法实现把<strong>换成<mark>这类节点级别的标签替换，因为这类映射关系是Writer内置的硬编码逻辑，不在模板的可调整范围内
• 如果只是想给特定class的div附加全局属性，模板方案的配置成本远高于Lua过滤器

设计原则说明：Pandoc的核心设计是将内容结构决策（AST层）和格式渲染逻辑（Writer层）做严格分离，所有自定义的结构调整都应该在AST阶段通过过滤器实现，不应该侵入Writer层的代码逻辑。

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