使用 Pandoc 将 Markdown 转换为 PDF 时使用 CSS

我正在 OS X 上尝试 Pandoc，迄今为止的结果令人印象深刻。然而，一个阻碍性问题是让 CSS 样式在内联代码示例上工作。我正在从 Markdown 转换为 PDF。

我的源代码中有这个字符串：

* Create a simple HTML document (<span class="filename">simple.html</span>) and load it into the browser via the file system

我也尝试过这个：

* Create a simple HTML document (`simple.html`{.filename}) and load it into the browser via the file system

我想在每种情况下将“文件名”类应用于所包含的文本，但它似乎对输出没有任何作用。然而手册说：

某些输出格式可以使用此信息进行语法突出显示。目前，使用此信息的唯一输出格式是 HTML 和 LaTeX。

这是我的命令：

pandoc \
    --output ./output.pdf \
    --css source/styles.css \
    source/en/docs/input.md

我正在转换为 PDF，这是由 Pandoc 内部使用 LaTeX 编写的。我可以让它发挥作用吗？或者，我可以使用通过 LaTeX 命令定义的样式吗？ - 它不一定是CSS。但是，它必须是一个样式系统 - 每次都更改斜体/字体/颜色属性是不可行的。

我尝试过将输出临时发送到 HTML，在这种情况下，样式是直接从特定样式资源导入的。因此，我的样式表规范和跨度标记是正确的，至少对于一种输出格式是正确的。

Addenda

一些事后的想法：

• 解决方案不一定是 Pandoc 或 Markdown。然而，它确实需要是一种简单的基于文本的标记语言，可以可靠地转换为 PDF，因为我想将文档文件存储在 Git 上以便于分叉和合并。我不喜欢 HTML，因为它很冗长，而且转换它的引擎也不是很好（尽管，不可否认，我的格式要求并不高）。
• Pandoc 的 HTML 输出很好，所以如果我能找到能够可靠地将（简单）HTML/CSS 转换为 PDF 的东西，我会没事的。当然，Pandoc 应该能够做到这一点，但内联样式（用于代码片段的背景颜色）不会呈现。这可能有点麻烦，因为我必须重新引入分页符之类的东西，这在 HTML 到 PDF 转换器中可能很重要。

“我想在每种情况下将“文件名”类应用于所包含的文本，但它似乎对输出没有任何作用。”

它适用于 HTML。交互式运行 Pandoc，^D查看生成的代码：

$>  pandoc -f markdown -t html

* Create a simple HTML document (`simple.html`{.filename}) and load it.

^D

<ul>
<li>Create a simple HTML document (<code class="filename">simple.html</code>) and load it.</li>
</ul>

如果您使用 LaTeX，则它不起作用.filename班级。您需要使用其中之一known类名：

$>  pandoc -f markdown -t latex

* Create a simple HTML document (`simple.html`{.filename}) and load it.

^D

\begin{itemize}
\tightlist
\item
  Create a simple HTML document (\texttt{simple.html}) and load it.
\end{itemize}

现在使用其中之一known类名，例如.bash, .postscript, .php, ...:

$>  pandoc -f markdown -t latex

* Create a simple HTML document (`simple.html`{.bash}) and load it.

^D

\begin{itemize}
\tightlist
\item
  Create a simple HTML document (\VERB|\KeywordTok{simple.html}| and
  load it.
\end{itemize}

要将 HTML + CSS 转换为 PDF，您还可以查看PrinceXML，对于非商业用途是免费的。