[Doxygen-users] Creating links in and between Markdown files/pages

[Paul A. L. <pa...@le...>]

Greetings, documentation enthusiasts.

I have created a simple doxygen example (see attached file). What I want 
to make (for now) is a "User Manual" style document. Later I will 
include source code documentation, but for now, I am looking to 
implement the current user manual in Markdown + doxygen. In this 
document, it would be nice to be able to create links both inside a 
single page, and between pages. However, I can't see a way of doing this 
in the Markdown syntax supported by Doxygen.

I am perfectly willing to accept something along the lines of a "\page 
foo" or "\label foo" directive (i.e. syntax outside Markdown)  once per 
file/top section header, but it would be beneficial to keep this 
doxygen-specific stuff to an absolute minimum, as we hope to use the 
same Markdown source for several purposes.

Links are essential for HTML output. For LaTeX/PDF we can live without, 
but it sure would be a great thing to have there, too. Can anyone help 
me with this?

Best regards, and thanks for creating this awesome tool.
Paul