如何转换 Markdown CSS -> PDF？

Question

我正在尝试将 Markdown 文件转换为 PDF。我只寻找两件事：

• 一种轻松更改 pdf 样式的方法（例如使用 CSS 文件）
• 代码块的语法高亮

我可以使用哪些工具？我尝试了 Pandoc，但它使用 Latex 进行格式化，这并不容易使用。

原文由 pimpampoum 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

您可以为此使用 gh-md-to-html ，这是一个命令行工具，可以完全满足您的需求（完全披露：我是作者）。

您可以通过 安装 wkhtmltopdf 然后使用

pip3 install gh-md-to-html[pdf_export]

然后使用

gh-md-to-html path_to_your_file.md -p <name>.pdf -c path_to_your_css.html

让我们剖析一下这个命令的各个部分的作用：

• -p 选项声明在哪个文件名下保存生成的 pdf 文件； “ <name> ”会自动替换为您的输入文件的名称。
• -c 选项是指向 html 文件的路径，该文件在 <style> 标签中包含 css，该文件将嵌入到生成的 html 文件中转换为pdf。

顾名思义， gh-md-to-html 将文件转换为 html，然后使用 wkhtmltopdf --- 将文件转换为 pdf。

无论如何，生成的 pdf 文件的样式类似于 GitHub 对其 README 文件的样式；如果您想禁用它以便可以使用自定义 css 指定整体样式，您可以为命令提供选项 -s false ，这将禁用默认样式。不过，代码块在这两种情况下都正确突出显示了语法。

转换过程部分在线完成（使用 GitHub 的 markdown REST API）；如果你不想这样，你可以使用 pip3 install gh-md-to-html[offline_conversion] 然后运行 gh-md-to-html 与 -o OFFLINE 选项。

原文由 phseiff 发布，翻译遵循 CC BY-SA 4.0 许可协议