如何在 Pandoc 中从 docx 转换为 markdown 时呈现 yaml 块答案

【问题标题】：How can I render yaml block while converting from docx to markdown in Pandoc如何在 Pandoc 中从 docx 转换为 markdown 时呈现 yaml 块
【发布时间】：2020-05-04 19:58:50
【问题描述】：

我有一些 docx 文档在标题中包含一些像这样的 yaml 信息

---
key: value
---

我正在使用 Pandoc 使用 markdown_mmd 将它们转换为 markdown 这些值是为了保持降价，但是当我转换它们时，yaml 块会被 Pandoc 忽略

问题：如何保留 YAML 块并将其原样呈现到降价文件中？

【问题讨论】：

你的意思是你把它作为文本在word文档中作为富文本？那行不通...但是您可以使用--metadata-file myfile.yaml 选项来使用外部纯文本文件..

标签： python markdown docx pandoc

【解决方案1】：

您可能需要指定以下内容：

--standalone -t markdown_mmd+yaml_metadata_block

Pandoc 包括对 yaml_metadata_block 的支持，markdown 格式默认包含该支持。但是，文档特别指出了以下有关使用扩展生成 Markdown 输出的内容：

当 pandoc 与 -t markdown 一起使用来创建 Markdown 文档，只有在以下情况下才会生成 YAML 元数据块使用-s/--standalone 选项。所有元数据都将出现在文档开头的单个块中。

因此，您需要在选项中包含--standalone。

此外，当您使用 Markdown 变体时，您需要确认该变体包含扩展程序。根据每个变体支持的list of extensions，我没有看到markdown_mmd 下列出的yaml_metadata_block。因此，您可能需要明确地enable the extension。像这样：

-t markdown_mmd+yaml_metadata_block

注意：根据--standalone 选项的说明，我不确定您是否需要专门启用扩展。而且我没有测试它。因此，我建议在显式启用和不启用扩展的情况下尝试它，看看它是否有所作为。如果两者都不起作用，那么您可能需要使用 markdown 变体，然后显式启用/禁用各种扩展以获得 markdown_mmd 行为。

【讨论】：