[Doxygen-users] markdown support for header is messed up in doxygen

[Zack S. <za...@gm...>]

Hello all,

I have encountered several issue with doxygen and using markdown.
Especially the support for headers (the <hN> tag in HTML).

e.g.:
https://bugzilla.gnome.org/show_bug.cgi?id=744755
https://bugzilla.gnome.org/show_bug.cgi?id=744761

Now I encountered  a problem, where I want to give the main header a 
number in the title
e.g.:

2. My Title  {#my_title_page}
=========

This will result in following HTML rendering

<div class="title h1">
     <ol type="1">
         <li>My Title </li>
     </ol>
</div>

and <title>2. My Title</title>

So in fact it will display wrong:
1. My Title

only the title is correct:
2. My Title
in the title page.

Please I need some workarounds or fixes for all this issues.
Markdown support should be first class, because it is a standard format, 
which will can be reused for other tools too.

Regards,
Zack