Pandoc编译时不显示YAML前置元数据日期问题求助

环境信息 #

• Pandoc版本：pandoc 3.7.0.2（Features: -server +lua，脚本引擎Lua 5.4）
• 操作系统：Ubuntu 26.04 LTS，内核Linux 7.0.0-22-generic

问题描述 #

将4000字的Markdown文件通过Pandoc转换为PDF时，无论通过YAML元数据还是命令行参数设置的日期都无法显示，但相同操作在小型Markdown文件中可正常生效。

已尝试的操作 #

1. 测试两种YAML日期格式均无效：

   ---
   date: June 14, 2026
   linestretch: 1.5
   ---
   

   ---
   date: 2026-06-14
   linestretch: 1.5
   ---
   

2. 移除linestretch参数后，日期仍不显示
3. 使用基础转换命令：

   pandoc j.md -o jtest.pdf
   

4. 通过命令行指定日期参数：

   pandoc j.md -s --variable date="June 14, 2026" -o jdate.pdf
   

可能的解决方法 #

1. 检查模板日期占位符
   Pandoc默认LaTeX模板包含日期字段，但如果大文件使用了自定义模板，可能缺失$date$占位符。可通过以下命令查看默认模板内容：

   pandoc -D latex
   

   搜索date确认是否存在\date{$date$}代码段，自定义模板需添加该占位符。

2. 强制使用独立模式与默认模板
   明确指定默认LaTeX模板执行转换：

   pandoc j.md -s --template=default.latex --variable date="June 14, 2026" -o jdate.pdf
   

3. 校验YAML元数据格式
   大文件可能存在YAML格式错误（如缩进、特殊字符）导致解析失败，用yamllint工具校验：

   sudo apt install yamllint
   yamllint your_yaml_content.yaml
   

4. 分块排查文件内容
   将大文件拆分为多个小部分，逐一转换测试，定位是否某段内容干扰了元数据解析。

5. 更新LaTeX依赖包
   尝试更新TeX Live相关包：

   sudo apt update && sudo apt install --only-upgrade texlive-full
   

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