Explore markdown comments

[alandefreitas]

Doxygen's language:

• It's poorly documented enough to develop a second independent implementation in Clang, and there will always be conflicts.
• Has lots of historical cruft
• Is unique, that is, no other language uses it besides similar versions in Javadoc (the original tool for Java) and Javascript doc comments

Doxygen itself already supports HTML like commands.

As for Markdown:

• There are parsers under permissive licenses
• The most important commands are simple to implement
• Markdown quickly became a de-facto standard for plain text markup, so it could drive adoption.
• Very few people ever learn advanced concepts of Doxygen, but many already know ins and outs of Markdown.
• Languages that appeared within the last decade, like Swift and Rust, use Markdown for documentation comments (they use custom limited implementations)