<p>I am searching for a way to generate Markdown files from XML Documentation files (like the ones generated by Visual Studio). I have found several tools (Vsxmd, DefaultDocumentation, etc.) that do this for .NET/C# projects, but I couldn't find anything similar for C++.</p>
<p>Of course, I know there is Doxygen, but in my oppinion its output looks kind of &quot;stale&quot;, which is why I want to generate Markdown files and publish them later using a static site generator.</p>
<p>I have spent hours on googling, but cannot find a smart way to do this. I don't want to just parse the XML file, but also generate code references for the undocumented items. Is that possible?</p>

CC BY-SA 4.0
2022-05-09T15:06:58.370Z
you could spend a few hours (er days) learning xml stylesheets!
Peter Turner
CC BY-SA 4.0
2022-05-10T06:20:37.393Z
As I mentioned in my post, I don't want to just parse the XML file, but also generate code references for the items that are not mentioned in the XML documentation file because they are not documented. Of course I know how to parse XML.
adlerzei
CC BY-SA 4.0
2022-05-10T13:20:39.843Z
you're a member of a dying breed then, I'd take advantage of your knowledge!  I've ran into the same problems with SuSE linux and their "Wicked" network manager.  It's about half documented, all the good parts are in the XML spec.
Peter Turner
<documentation>
Generating .MD files from XML Documentation for C++?
adlerzei
# Generating .MD files from XML Documentation for C++?

(Asked by: username_0 on 2022-05-09)

I am searching for a way to generate Markdown files from XML Documentation files (like the ones generated by Visual Studio). I have found several tools (Vsxmd, DefaultDocumentation, etc.) that do this for .NET/C# projects, but I couldn't find anything similar for C++.

Of course, I know there is Doxygen, but in my oppinion its output looks kind of "stale", which is why I want to generate Markdown files and publish them later using a static site generator.

I have spent hours on googling, but cannot find a smart way to do this. I don't want to just parse the XML file, but also generate code references for the undocumented items. Is that possible?

**Tags:** documentation

> **Comments:**
> **username_1**: you could spend a few hours (er days) learning xml stylesheets!  
> **username_0**: As I mentioned in my post, I don't want to just parse the XML file, but also generate code references for the items that are not mentioned in the XML documentation file because they are not documented. Of course I know how to parse XML.  
> **username_1**: you're a member of a dying breed then, I'd take advantage of your knowledge!  I've ran into the same problems with SuSE linux and their "Wicked" network manager.  It's about half documented, all the good parts are in the XML spec.  

---

## 0 answers

