Pandoc 用户使用指南 - 语法高亮

Pandoc 会自动为带有 语言名称标记的代码块 进行语法高亮。Skylighting 这个 Haskell 库被用来做高亮处理。目前，高亮功能只支持 HTML、EPUB、Docx、Ms、Man 和 LaTeX/PDF 输出格式。要查看 Pandoc 支持的语言名称列表，请输入 pandoc --list-highlight-languages 。

可以通过使用 --highlight-style 选项来选择颜色方案。默认的颜色方案是 pygments，它模仿了 Python 库 pygments 默认的颜色方案（但实际上并未使用 pygments 进行高亮）。要查看可用的高亮样式列表，请输入 pandoc --list-highlight-styles。

如果你对预定义的样式不满意，可以使用 --print-highlight-style 生成一个 JSON 格式的 .theme 文件，然后修改这个文件并将其作为 --highlight-style 的参数使用。例如，为了获取 pygments 风格的 JSON 版本：

pandoc --print-highlight-style pygments > my.theme

然后编辑 my.theme 文件，并像下面这样使用它：

pandoc --highlight-style my.theme

如果你对内置的高亮功能不满意，或者想要高亮一种不被支持的语言，可以使用 --syntax-definition 选项加载一个 KDE 风格的 XML 语法定义 文件。在自己编写之前，可以参考 KDE 的语法定义仓库 。

如果要禁用高亮功能，可以使用 --no-highlight 选项。