我花了一整天的时间试图弄清楚这一点,但我做不到。我找不到我正在寻找的解决方案。
我正在为进入我的项目的新开发人员准备一些
.md
wiki 文档,我想将它们导出为 PDF。它们必须是 PDF,遗憾的是这是一个要求。
我的问题是我希望文档具有与 GitHub 相同的风格,甚至与 VSCode 的 Markdown 预览风格相同。我尝试过的每个工具都没有使用与 GitHub 完全相同的风格。它们相似,但不相同或不够接近而无法通过。
这是我尝试过的:
使用 Markdown 编辑器:Typora、Obsidian、Dillinger。 GitHub 命名的主题或预设看起来都不可接受。
CLI 工具:没有真正尝试过这个。它们并不比其他的更有希望,并且需要更多的工作,而且我正在使用 Windows,因此增加了额外的复杂性。
浏览器扩展:没有一个看起来可以接受。
VSCode 扩展:没有一个看起来可以接受。
在编辑器和 IDE 上使用自定义
.css
文件:我的最佳镜头。我尝试下载 GitHub CSS 样式表并将其应用到 Typora、Obsidian 和一些 VSCode 扩展。我还尝试了许多其他解决方案,这些解决方案太多了,无法添加到这篇文章中,但我最接近的尝试是将 VSCode 的 Markdown PDF 扩展与自定义 CSS 文件一起使用,但我无法获得扩展来使用样式表。我知道这是可能的,而且可能非常简单,但我从未使用过 CSS 和样式,我很迷失。
简单地说,我想要一种方法将我的 MD 文件制作为 PDF,并使用 GitHub.com 为其
README.md
文件使用的相同样式。我不想要任何看起来相似的风格,我希望它看起来一模一样。作为第二个选择,我对 VSCode 用于 MD 预览选项卡的样式感到满意。
如果无法明确导出
MD
->PDF
,我可以执行 MD
->HTML
->PDF
或任何必要的步骤。
Markdown Viewer 非常接近。请参阅我对超级用户的回答
最好的方法可能是创建一个 GitHub 存储库,将所有自述文件推送到其中,然后编写一个脚本以转到实际 GitHub 网站上的所有 Markdown 页面,并从那里打印为 PDF。这对于私人和公共回购都可以完成。
我也研究了很多工具,但从未找到一个很好的命令行解决方案。
使用 Markdown 预览增强 VSCode 扩展,您可以将 Markdown 导出为 HTML。它还提供了直接导出为 PDF 的选项,但样式发生了变化。要保留样式,请首先将其另存为 HTML 文件,然后您可以将 HTML 文件转换为 pdf。