如何将带YAML头的Markdown文件合并为符合预期的Pandoc输出？

问题根源 #

Pandoc处理多文件时，会覆盖前置文件的YAML元数据，仅保留最后一个文件的元数据，这就是最终文档标题、摘要取自05.md的原因；同时默认不会渲染各子文件YAML中的标题内容。

无需额外工具的简便解决方案 #

1. 保留index.md的全局元数据 #

通过--metadata-file参数指定index.md为全局元数据来源，后续文件的元数据不会覆盖它，同时index.md的正文仍会正常加入文档：

pandoc --metadata-file=index.md -o readme.pdf index.md 0*.md

2. 自动显示子文件的标题 #

利用sed命令批量将0*.md的YAML标题转换为Markdown标题格式，无需手动修改文件：

for file in 0*.md; do
  sed -e '1,/---/{/title:/s/title: \(.*\)/# \1/; /---/d}' "$file" > "${file%.md}_processed.md"
done

执行后会生成带Markdown标题的处理文件，再合并即可：

pandoc --metadata-file=index.md -o readme.pdf index.md 0*_processed.md

3. 一键自动化命令 #

用进程替换直接传递处理后的内容，无需生成临时文件，一步完成：

pandoc --metadata-file=index.md -o readme.pdf index.md <(for f in 0*.md; do sed -e '1,/---/{/title:/s/title: \(.*\)/# \1/; /---/d}' "$f"; done)

自定义优化 #

• 若想将子文件标题设为二级标题，把sed命令中的# \1改为## \1即可。
• 如需保留子文件的摘要，可扩展sed命令将摘要转为块引用格式：

sed -e '1,/---/{/title:/s/title: \(.*\)/# \1/; /abstract:/s/abstract: \(.*\)/> \1/; /---/d}' "$f"

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