为什么在 LaTeX 转换为纯文本时 Pandoc 不包含摘要？答案

【问题标题】：Why does Pandoc not include abstract when LaTeX is converted to plain text?为什么在 LaTeX 转换为纯文本时 Pandoc 不包含摘要？
【发布时间】：2021-10-11 20:31:08
【问题描述】：

我有一个乳胶文档 (example.tex)：

\documentclass{article}

\begin{document}

\begin{abstract}
  This does not get exported.
\end{abstract}

But this is fine.

\end{document}

并希望将其导出为纯文本：

pandoc --to=plain example.tex

但是，只有文档的正文被导出，摘要被排除在导出之外。

如何让pandoc 也导出我的摘要？

我相信这在文档中的某个地方得到了回答，但我只是在相对较长的时间里找不到在哪里。

【问题讨论】：

标签： pandoc

【解决方案1】：

这是一个有趣的问题，深入探讨了 pandoc 表示文档的方式。 tldr：摘要被视为元数据，默认情况下不包含在普通输出中。

以下是详细信息：pandoc 使用一个简单的文档模型，该模型由主文本以及 title 和 author 等附加元数据构建而成。我们可以在运行 pandoc -s -t gfm example.tex 时看到这一点，这将输出一个 GitHub Flavored Markdown 并将元数据包含在一个 YAML 块中。

---
abstract: |
  This does not get exported.
---

But this is fine.

摘要在那里，但在 YAML 元数据中。元数据是否以及如何包含在输出中取决于输出格式和 pandoc 使用的 template。 Pandoc 用文档中的数据填充模板。可以通过运行pandoc -D plain 来检查使用的默认模板，但是在幕后添加了一些特殊的变量，所以输出只是适度的指导。

对我们来说重要的是我们可以使用自定义模板来包含摘要：

ABSTRACT
--------

  $abstract$

$body$

那么如果我们使用 pandoc 运行

pandoc -t plain --template=OUR-TEMPLATE.plain example.tex

我们得到我们想要的：

ABSTRACT
--------

  This does not get exported.


But this is fine.

【讨论】：