使用Pandoc模板转PDF时YAML元数据解析报错求助

原因分析 #

这个警告的核心是YAML元数据语法不符合规范，大概率是以下情况：

• 缩进错误：disable-header-and-footer: true这行的缩进和其他元数据键不一致，或者直接顶格书写。YAML对同级键的缩进要求严格（推荐用2个空格，禁止用Tab），缩进不匹配会直接触发解析错误。
• 语法遗漏：比如YAML块的开头/结尾---标记不完整，或者这行前后存在未闭合的引号、未完成的键值对，但因为移除这行后恢复正常，所以缩进问题的可能性最大。

解决办法 #

1. 统一缩进格式
   确保disable-header-and-footer: true和其他元数据键的缩进完全一致，示例如下：

   ---
   title: 我的文档
   author: 测试作者
   disable-header-and-footer: true
   ---
   

   注意：所有同级键必须使用相同数量的空格缩进，不要混合Tab和空格。

2. 校验YAML语法
   手动检查元数据块：确认每个键值对的冒号后都有空格，没有未闭合的单/双引号，开头和结尾的---标记完整且单独占一行。

3. 确认模板版本
   如果使用的是旧版Eisvogel模板，建议更新到最新版——disable-header-and-footer是模板官方支持的配置项，旧版可能存在兼容性问题。

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