有没有一种简单的方法将Markdown转换成漂亮的HTML文档，包括导航？

Question

3

我们计划使用Markdown编写软件文档，但为了提供可点击的Web视图，我们需要将Markdown文档转换为一组漂亮的HTML页面。

在我们的工作流程中，我们倾向于编写文档并将文档与源代码和二进制文件一起交付给客户。我找到了很多将单个页面转换为HTML的程序，但我想知道是否有一个好的转换器可以将Markdown页面和样式元素转换为可用的站点，包括子页面等导航元素？

- Marco

如果您愿意用reStructuredText（一种非常相似但稍微更高级的语法）来代替Markdown，那么您可以使用Sphinx系统：http://sphinx.pocoo.org/ - Vasiliy Faronov

3个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Rene Saarsoo · Answer 1

这是面向最终用户的文档还是针对开发人员的API文档？

如果是前者，我建议查看支持Markdown的Wiki软件。

如果是后者，您应该明确提及使用的编程语言。

- k107 · Answer 2

你应该看看 Gollum。它是Github维基软件的核心。它能将一个文本文件的Git存储库转换为维基百科。

- cindyxiaoxiaoli · Answer 3

这里有一篇博客介绍了几个使用Markdown维护文档的工具。ScreenSteps似乎最适合你。