Home/ Questions/Q 8862359
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-06-14T15:42:35+00:00

The documentation of Doxygen states, that I can use PHP Markdown Extra title labelling

  • 0

The documentation of Doxygen states, that I can use PHP Markdown Extra title labelling in a markdown file, but neither

# Main Page # {#mainpage}

nor

# Main Page # {#index}

works, but the label is not present in the output as plain text either. This is the very first line BTW.

Also I cannot reference to that page neither with the above labels, neither with the name of the file.

I also have a main.dox file that contains a \mainpage special command, but I also tried all the above with removing one slash before them (to make it only two).

I’m using Doxygen 1.8.2 (downloaded) and 1.8.1.1 (from MacPorts) for the task.

How can I achieve this then?

Also, how can I mark a markdown file as part of a specific language?

EDIT: i have enabled markdown support, and the file appears in the referenced pages.

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    In the next release of doxygen (1.8.3) I plan to introduce a new configuration option USE_MDFILE_AS_MAINPAGE which can be used to specify a markdown page that is to be used as the main page.
    Then you can configure doxygen as follows:

    INPUT                  = README.md other_sources
USE_MDFILE_AS_MAINPAGE = README.md

    and it will work regardless of page’s headings.

    • 0