Markdown 如何从c++；项目 我试图为一个复杂的C++项目创建一个文档。

为此，我开始使用Doxygen，这非常适合我的使用，因为我只需对项目的标题进行注释，就可以获得HTML格式的完整文档。中的此文档工作正常，样式良好

但这是我的问题，我想把这个文档放在一个降价文件中，以便能够将它推送到Gitlab上

我尝试使用moxygen将xml文件转换为md文件。它工作正常，但没有我想要的那么正常：由moxygen自动生成的锚不工作。演示文稿也是一个问题，例如，它将定义列表放在文件的顶部，该列表非常长，在文档中不是最有用的

我想知道是否有一种方法可以像使用Doxygen一样简单地记录我的代码，但要得到一个适当的标记文件（锚定工作并且更好的模板）

---

<>我知道降价语法很简单，但是我不能写整个的降价，因为这个项目很大，而且经常更新，所以我需要一个通用的方法来从C++项目中获取文档。p> 不久前我遇到了一个类似的问题，解决起来并不容易。基本上，我所做的是将文档转换为LaTeX，然后再转换为markdown。检查乳胶->降价通道（其他工具也存在）

在某种程度上，您可以使用make/latexmke自动化该过程，但我个人无法使该过程变得简单，有时我仍然需要介入。还请注意，您可能需要使用其他工具，如flex，将LaTeX文档制作成一个大的

tex

文件。某些转换程序不接受拆分

tex

文件

---

这并不完美，但可能会给你另一个角度。希望它有帮助。< /P>这不是C++问题。请删除标签。其次，这基本上是一个需要文档/教程的问题。这是离题的，所以。请阅读。为什么不将生成的HTML推送到gitlab，或者从生成的LaTeX输出或docbook或。。。？如果从xml转换为markdown，我认为您应该联系moxygen的开发人员。谢谢您的回答。我不能将其作为PDF格式发布，因为我在一家公司工作，我们的文档需要直接从gitlab使用，比如markdown，它集成到gitlab中。将其作为HTML推送可能是一个很好的解决方案，但我还不知道如何简单地推送和链接它，我将对此进行调查。最好的解决方案是获得一个适当的标记文件。因此，您需要一个HTML到标记转换工具。不幸的是，它们是罕见的，除了少数例外，它们往往是不完整的。不管怎样，工具建议在这里是离题的。谢谢你的回答。我已经读过这个将我的Latex转换成HTML的工具，但是我不知道有一种方法可以将所有的tex文件收集成一个大文件，所以我放弃了这个想法。但从这个角度看，它看起来更好，我会尝试下一次我的文件。我使用的解决方案是为Doxygen编写include文件上的文档。然后获取一个XML文档，将其转换为Markdown，最后通过编辑生成的Md文件手动更正锚问题和演示文稿。这是我找到的最好的解决方案，直到收到您的邮件为止，但它仍然很长。是的，请参阅第3.1节的指针。