Quarto/Pandoc Lua过滤器无法读取元数据变量问题求助

核心问题修复方案 #

问题1：跨函数变量共享失效 #

Pandoc Lua过滤器的Meta与CodeBlock是独立执行的处理函数，局部变量无法跨函数访问。需将目标语言变量定义为全局作用域的变量，让两个函数能共享数据。

问题2：代码块移除方式错误 #

返回{}会生成空的代码块节点，要彻底移除代码块，需返回nil，告知Pandoc直接丢弃当前节点。

完整可用的Lua过滤器代码 #

-- 全局作用域定义变量，存储目标语言
local target_lang = nil

function Meta(meta)
  -- 读取YAML头中的target_lang字段，兼容文本类型的元数据
  target_lang = meta.target_lang and meta.target_lang.text or nil
  return meta
end

function CodeBlock(block)
  -- 未指定目标语言时，保留所有代码块
  if not target_lang then
    return block
  end
  
  -- 获取当前代码块的语言标识（对应````{lang}`中的lang）
  local block_lang = block.attr.classes[1] or ""
  
  -- 语言不匹配则返回nil移除代码块，匹配则保留原块
  if block_lang ~= target_lang then
    return nil
  end
  return block
end

使用步骤 #

1. 在Quarto文档的YAML头中添加目标语言配置：

---
title: "测试文档"
target_lang: "python"  # 替换为你需要保留的语言，比如r、bash等
---

2. 将过滤器代码保存为lang-filter.lua，执行渲染命令：

quarto render test.qmd --lua-filter=lang-filter.lua

关键细节说明 #

• 全局变量共享：在函数外部定义local target_lang，让Meta函数读取YAML配置后赋值，CodeBlock函数可直接读取该变量。
• 代码块语言获取：代码块的语言标识存储在block.attr.classes[1]中，对应代码块开头指定的语言类型。
• 容错处理：如果YAML头未设置target_lang，过滤器会默认保留所有代码块，避免误删内容。

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