java - 在 Maven 构建期间从 Markdown 文件生成 PDF 文档

Question

我有一个带有 Maven 程序集插件的 Java 项目。Assembly Plugin 构建了一个最终的 ZIP 发布文件，其中包含二进制文件 (*.war)、配置文件和一些 PDF 文档。

这些文档是用 Markdown 编写的，在我使用 Maven 执行构建之前，需要手动生成发布的 PDF 文档（例如使用Markdown 到 PDF 在线工具）。然后，Assembly 插件获取 PDF 并将它们放入最终的 ZIP。

几乎每次创建发布 ZIP 文件时，我都忘记手动生成 PDF，因此通常最终的 ZIP 包含旧文档。这太糟糕了。

我想自动生成 PDF。我已经检查了四个 MD 到 PDF 的 maven 插件，但它们都不能正常工作。我找到了一个将 MD 生成为 HTML 的插件（没有任何默认样式表），也许我可以使用另一个插件将 HTML 转换为 PDF，但这太痛苦了。

我尝试了什么：

• maven-site-plugin + doxia：只生成 HTML，不生成 PDF
• markdown-page-generator-plugin：只生成没有默认样式表的 HTML，并且需要有外部的页眉、页脚模板 HTML
• maven-pdf-plugin：制作一个包含几乎“整个世界”的大报告，而不仅仅是 *.md 文件
• markdowndoc-maven-plugin：它来自不同的 repo 和插件 repo，我无法将其添加到 pom.xml 中，并且使用起来很复杂。

是否有任何简单的方法可以在构建过程中基于 Markdown 文件使用 Maven 生成 PDF 文件？

标签： javamavenpdf-generationmarkdownmaven-plugin