Doxygen does not create a markdown table

Question

Doxygen outputs text in place of the expected table. The file text is:

/*! \file
    \brief Hardware definitions and macros.


    The processor is an ATmega32U2. The pins and their functions are:

    | Pin | I/O  | Function |
    | --: | :--: | :------- |
    |  1  | I    |  ~RESET  |
    | 28  | P    | VCC      |
*/

The HTML output from the table is:

| Pin | I/O  | Function || --: | :--: | :------- ||  1  | I    |

It's the tilde symbol which causes the problem, after omitting it, the table was output as expected.

Is this a bug or a special feature?

Answer 1

Works for me with Doxygen 1.8.5 even with the tilde; but the first column of vertical bars must be removed:

 Pin | I/O  | Function |
 --: | :--: | :------- |
  1  | I    |  ~RESET  |
 28  | P    | VCC      |

instead of

| Pin | I/O  | Function |
| --: | :--: | :------- |
|  1  | I    |  ~RESET  |
| 28  | P    | VCC      |