Re: [Doxygen-users] Structured elements in Markdown

[Leonardo P. S. <Leo...@on...>]

Hello All!

I just discovered that things work if I define an anchor with the title:

### Some Section {#some_section_label}

If I just use

### Some Section

The title gets rendered correctly, but it’s not included in the TOC, HTML treeview, etc.

Regards,

From: Leonardo Pereira Santos
Sent: August-02-19 6:26 PM
To: dox...@li...
Subject: Structured elements in Markdown

Hello All!

I just discovered that using Markdown will not generate a proper section with Doxygen.

My Markdown file is:


# Introduction {#introduction_anchor}

## Purpose

lalalala

The ‘Introduction’ gets translated to a chapter title, which is pretty cool. I expected the ‘Purpose’ header2 to be translated as a section. But the HTML/PDF output is just


Top<index.html> Title
*          Introduction<index.html>
*          Second Chapter<second_chapter_anchor.html>

There’s no ‘Purpose’ under ‘Introduction’.

If I use Doxygen’s \section, I get the desired result in both HTML and LaTeX.

Top<index.html> Title
*        ▼<javascript:void(0)>Introduction<index.html>
o         Purpose<index.html#sec>

Is this by design?

Thank you.

____________________________________________________________
Leonardo Pereira Santos | ON Semiconductor
Design Engineer

200-611 Kumpf Dr        | Waterloo, Ontario, Canada, N2N 1A8
519-884-9696 x2269 (O)  | Leo...@on...<mailto:Leo...@on...>