我想在Github上为我的开源项目生成API文档。我想从我的C＃项目中的XML文档注释中自动创建它们。我的微弱的谷歌搜索出现了bubkiss。有没有办法做到这一点？
我更喜欢它是Github风格的Markdown。
答案 0 :(得分：6)
在搜索了一下之后，我发现了这个要点的宝石：
Generates Markdown from VS XML documentation file
它打印到C＃XML - ＆gt;降级到控制台。我确信它可以进一步改进，但这是一个非常好的开始。我已经对它进行了测试，并且它完全正常工作。
答案 1 :(得分：6)
这是在线 C＃XML doc to Markdown转换器：http://varus.io/vsdoc-2-md/
它基于@ formixian的算法。
答案 2 :(得分：5)
我最终使用Sandcastle生成纯HTML并使用它。不可避免地，我只会为Sandcastle编写自己的解析器或自定义模板。
我不喜欢Doxygen或QDoc的学习曲线。
答案 3 :(得分：3)
我会推荐Doxygen。通过使用配置文件和XSLT配置Doxygen，您几乎可以使用它做任何事情。 http://www.doxygen.nl/
在配置文件中设置源文件和输出，然后使用XSLT自定义输出。
对于Doxygen，有一个解析器工具（http://code.google.com/p/doxygenxmlparser/）已经准备好用C＃完成大部分工作
if（youDoNotLikeThisIdea == true） 另一个高度可配置的工具是QDoc（Qt API的一部分）@ http://qt-project.org。当然，使用QDoc会要求您特别构建Qt和QDoc。
祝你好运！