如何去除Markdown脚注文中引用的多余括号？

问题成因 #

你用[@bibkey]区分脚注里的注释与引用，但Pandoc的citeproc会默认把这种格式解析成带外层括号的引用。当引用前有注释文本时，就会出现多余的括号嵌套——比如原本想写如前所述[@smith2020]，结果渲染成如前所述(Smith, 2020)或多一层括号。

不用改原文档的解决方案：自定义Lua过滤器 #

通过下面的Lua过滤器处理Pandoc的中间AST，自动移除脚注中[@bibkey]带来的多余外层括号，同时保留OSCOLA的引用样式。

编写过滤器文件 #

新建一个名为fix-oscola-footnote-cites.lua的文件，粘贴以下代码：

function Note(note)
  -- 遍历脚注内的所有元素
  for idx, elem in ipairs(note.content) do
    -- 定位citeproc生成的引用Span（带citation类）
    if elem.t == "Span" and elem.classes:includes("citation") then
      -- 检查是否是[@...]转换来的带外层括号的结构
      local content = elem.content
      if #content >= 2 and content[1].text == "(" and content[#content].text == ")" then
        -- 移除首尾的括号，保留内部引用内容
        table.remove(content, 1)
        table.remove(content, #content)
        elem.content = content
      end
    end
  end
  return note
end

调用过滤器的两种方式 #

1. 在RMarkdown中配置

在你的.rmd文件的YAML头部添加上过滤器和OSCOLA的CSL文件路径：

output:
  word_document:
    pandoc_args:
      - "--lua-filter=fix-oscola-footnote-cites.lua"
      - "--csl=oscola.csl"  # 确保这个文件在你的工作目录里

2. 直接用Pandoc命令转换

如果是直接处理.md文件，用这条命令：

pandoc your-document.md -o output.docx --lua-filter=fix-oscola-footnote-cites.lua --csl=oscola.csl --citeproc

效果说明 #

这个过滤器只会处理脚注里的引用，不会影响正文格式。它会自动识别由[@bibkey]生成的带外层括号的引用节点，去掉多余括号，让脚注里的注释文本和引用自然衔接，完全符合你要的规范，且无需修改原文档内容。

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