Using markdown with Doxygen is extremely useful and productive. Doxygen converts markdown just fine, but is more conservative and does not convert markdown backticks, emphasis, and bold in certain cases when these are used in the middle of words. I can see why this limitation is useful. However, this limitation is annoying and unnecessary when combining backticks with * or _ for emphasis of code, as for example in:
*`emphasized code`*
**`bold code`**
which do not produce the result that is expected with other markdown conversion tools:
emphasized code
bold code
I really wish this was possible with Doxygen, without resorting to HTML tags, since I want to use style sheets that show different code styles for these three forms.
Any possibility this will be considered in a future Doxygen update?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Using markdown with Doxygen is extremely useful and productive. Doxygen converts markdown just fine, but is more conservative and does not convert markdown backticks, emphasis, and bold in certain cases when these are used in the middle of words. I can see why this limitation is useful. However, this limitation is annoying and unnecessary when combining backticks with
*
or_
for emphasis of code, as for example in:which do not produce the result that is expected with other markdown conversion tools:
emphasized code
bold code
I really wish this was possible with Doxygen, without resorting to HTML tags, since I want to use style sheets that show different code styles for these three forms.
Any possibility this will be considered in a future Doxygen update?