yaml - 使用 pandoc 转换时如何在 YAML header 中保留注释

Question

我有一个 Markdown 文件，其中包含混合 Markdown 和 TeX 内容，这意味着最终要转换为 PDF。
我有一个类似这样的 YAML header :

---
title: "mytitle"
#author: [someone]
lang: "de"
date: \today
toc: false
toc-own-page: false
numbersections: false
listings: true
header-includes: |
    \usepackage{amsmath}
    \usepackage{mathtools}
    \usepackage{amssymb}
    \usepackage{wasysym}
    \usepackage{extarrows}
    \usepackage[iso,german]{isodate}
    \setcounter{page}{1}
---

现在我使用 pandoc 在每次保存时“美化”/格式化我的文档: pandoc -f markdown -t markdown --standalone -Vheader-includes='' --reference-links这会产生以下输出:

---
date: "`\\today`{=tex}"
header-includes: |
  ```{=tex}
  \usepackage{amsmath}
  \usepackage{mathtools}
  \usepackage{amssymb}
  \usepackage{wasysym}
  \usepackage{extarrows}
  \usepackage[iso,german]{isodate}
  \setcounter{page}{1}
  ```
lang: de
listings: true
numbersections: false
title: mytitle
toc: false
toc-own-page: false
---

虽然我对 {=tex} 不满意-blocks，我明白为什么它们可能有意义并且知道我可以用 -t markdown-raw_attribute 禁用它们
但是有没有办法将注释掉的作者保留在 YAML header 块中？

Answer 1

Pandoc 不保留 YAML 块中的文本表示，不可能保留注释。您可以使用 _ 作为未使用的 YAML key 的前缀以免影响其他输出。
可以将 YAML 保存在一个单独的文件中并将其包含在 --metadata-file=... 中。 ，这样可以轻松确保仅处理文本。