Pandoc Lua过滤器如何为Para元素添加class类属性

报错的核心原因很明确：你用的Pandoc版本里，Para段落、BulletList无序列表这类块元素的AST结构，只包含content内容字段，根本没有定义attributes属性表。直接访问el.attributes拿到的是nil值，后续给nil做索引赋值自然会抛错。

根据你的输出场景选对应写法就行：

方案1：只需要输出HTML（最直接，完全匹配你的预期结果） #

不需要升级Pandoc，也不用改其他配置，直接把过滤器改成下面的写法：

Para = function (el)
  -- 跳过空段落防止匹配出错
  if #el.content == 0 then return el end

  -- 把当前段落单独转成HTML字符串
  local para_html = pandoc.write(pandoc.Pandoc(el), 'html')
  -- 提取<p></p>标签中间的正文内容
  local inner = para_html:match("^<p>(.*)</p>%s*$")
  if not inner then return el end

  -- 直接返回拼好的带lead类的p标签原生块
  return pandoc.RawBlock("html", '<p class="lead">' .. inner .. '</p>')
end

用你给的测试文档跑这个过滤器，就能直接得到你要的输出：

<p class="lead">Lead text for this section</p>

方案2：需要兼容多格式输出（LaTeX/EPUB/DOCX等） #

如果要同时导出其他格式，怕原生HTML块破坏其他格式的渲染，可以先给目标段落套一层带对应class的Div：

Para = function (el)
  -- 给段落包一层带lead类的Div
  return pandoc.Div(el, pandoc.Attr("", {"lead"}))
end

这个写法在非HTML格式下会自动忽略Div的class属性，不会影响正常排版。如果要在HTML输出时去掉多余的Div层、把class转移到内部p标签上，再加一段简单的HTML渲染规则就行。

补充：Pandoc 3.0及以上的新版本已经给Para、BulletList这类块元素新增了attr属性支持，如果升级到最新稳定版，也可以先初始化属性表再赋值，但要注意低版本兼容问题：

Para = function (el)
  el.attributes = el.attributes or {}
  el.attributes["class"] = "lead"
  return el
end

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