md,pdf和html格式的文档

时间:2013-02-20 09:13:50

标签: github documentation

我正在Github上开发一个开源项目。我用Github的md格式创建了一些文档。但是,我希望这些文档有三种格式:

  1. PDF:与项目一起下载
  2. HTML:托管在我的个人网站上。
  3. Markdown(.md):对于Github。
  4. 显然我不喜欢写三次。有没有什么方法我在任何地方写一次(虽然MS Word首选),它可以转换为其他两种格式?

2 个答案:

答案 0 :(得分:1)

考虑Pandoc

我会写下Markdown并转换为其他人。

答案 1 :(得分:1)

另一种可能性是DITA。它的免费参考实现DITA Open Toolkit允许您开箱即用生成HTML和PDF,并且可以自定义以生成Markdown。

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