Re: Structured elements in Markdown

Leonardo Pereira Santos <[email protected]> Wed, 7 Aug 2019 20:12:43 +0000
Newsgroups gmane.text.doxygen.general
Message-ID <19D444D2299FEE43A99CCB03048F85200BBFEDD6@usaz01ws0035.ad.onsemi.com>
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: [email protected]
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)  | [email protected]<mailto:[email protected]>

_______________________________________________
Doxygen-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/doxygen-users