如何将Markdown的header-includes提取为外部文件并正确引用？

首先得明确报错的核心原因：你把原来放在Markdown YAML header-includes里的LaTeX前置代码（比如\usepackage这类只能在LaTeX前置区执行的命令）提取到header-include.tex后，如果直接在Markdown正文里用\input引用，这个\input会在文档正文阶段执行，而LaTeX规定这类前置命令只能在前置区（preamble）运行，所以才触发了错误。

给你几个可行的解决方式：

方式一：用Pandoc命令行参数指定前置文件 #

把header-include.tex里只保留原来header-includes中的纯前置代码（别混入任何正文内容），编译时直接通过命令行参数让Pandoc把这个文件插入到LaTeX前置区：

pandoc 你的文档.md -o 输出文件.pdf --include-in-header=header-include.tex

这种方式不用修改每个Markdown文件的内容，编译时统一指定即可，适合批量处理多个文件的场景。

方式二：在Markdown的YAML元数据里引用前置文件 #

如果想在每个Markdown文件里统一配置，避免每次敲命令行参数，可以在文件开头的YAML块中这样写：

---
header-includes: |
  \input{header-include.tex}
---

关键是把\input放在YAML的header-includes字段内，Pandoc会自动将这个字段的内容插入到LaTeX前置区，此时\input会在前置阶段执行，里面的命令就不会触发错误了。

注意事项 #

• 确保header-include.tex里只有LaTeX前置区允许的内容：比如\usepackage、\setlength、\pagestyle这类，绝对不能放正文内容（比如段落、图片、列表），否则仍会报错。
• 要保证header-include.tex的路径正确，编译时Pandoc能找到它，要么和Markdown文件同目录，要么填写绝对路径。

内容的提问来源于stack exchange，提问作者Marc Le Bihan