github - md、pdf 和 html 格式的文档

Question

我正在 Github 上开发一个开源项目。我创建了一些 Github 的 md 格式的文档。但是，我希望这些文档以三种格式提供：

1. PDF：与项目一起下载
2. HTML：托管在我的个人网站上。
3. Markdown (.md)：用于 Github。

显然我不想写三次。有什么方法我可以在任何地方写一次（尽管首选 MS Word）并且可以将其转换为其他两种格式？

Answer 1

考虑潘多克

我会用 Markdown 写，然后转换成其他的。

Answer 2

另一种可能性是 DITA。它的免费参考实现 DITA Open Toolkit 让您可以开箱即用地生成 HTML 和 PDF，也可以自定义生成 Markdown。

但是，DITA 可能是一个比您需要的更复杂的解决方案，这取决于您对内容重用的要求、文档的大小、更新的频率、您是否会雇用技术作家来维护和更新您的文档......一种功能强大的解决方案，比一次性临时情况更适合专门的文档工作。