[Doxygen-develop] Generating TOC for .md files

[Randy Y. <ya...@ie...>]

if i've specified the "recurse" option, and one of my file types is
.md (markdown), so that i can get my document files into my generated
doxy output, how do i group multiple .md files, say, in one specific
subfolder, under one top-level menu in the doxy output's toc pane (the
left pane on the main page)?

so e.g., if i have msg/doc1.md and msg/doc2.md, i want there to be one
Messages entry in the doxygen output with each of the document titles
as submenus, for example, "How to clean your oven" and "Roast Duck
Soup Recipe", respectively.

so the doxygen-generated output would have:

Message
 How to clean your oven
 Roast Duck Soup Recipe

with the .md contents under each?

i am aware of the "# doctitle" method for naming docs in the toc pane,
but not how to group them

more generally, where is the format of the doc header comment formats
inside .md files for doxygen?

 --Randy Yates, DSP/Embedded Firmware Developer