TOC not generated when using a particular Markdown header style

[mrsmond]

Mainly as a note to others as this is not critical and has a work-around.

Doxygen v1.8.15

Table of contents (TOC) is not generated when using the === or --- style of headers in Markdown. It does generate correctly when using the # style of headers.

Example files attached. header_style_2.md (# style) works fine, however header_style_1.md:

Title {#mainpage}
===

[TOC]

One
===

Two
===

Three
===

Issues these warnings:

header_style_1.md:6: warning: multiple use of section label 'autotoc_md0' while adding section, (first occurrence: header_style_1.md, line 1)
header_style_1.md:9: warning: multiple use of section label 'autotoc_md1' while adding section, (first occurrence: header_style_1.md, line 1)
header_style_1.md:12: warning: multiple use of section label 'autotoc_md2' while adding section, (first occurrence: header_style_1.md, line 1)

As you can see from the Doxyfile, I have TOC_INCLUDE_HEADINGS > 0 as per #6513, which is related, but not the same problem. The extra header 1 section is needed due to bug #5892.

toc_test.tar.gz

[mrsmond]

Interestingly, the source for the markdown documentation page has a [TOC] at the start, but there is no TOC in the HTML output.

[albert-github]

The problem regarding the 'multiple use of section label' this was indeed the case in v1.8.15 but has been solved in the master version by the pull request #6780 based on issue #6779 and I see the TOC in both versions of the file in the master version of doxygen,.

The problem with [TOC] in the documentation has to be investigated a bit further.

[albert-github]

I've just pushed a proposed patch, pull request #6792, regarding the [TOC]

[albert-github]

Code has been integrated in master on github.

[doxygen]

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.8.16.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).