Doxygen does not create markdown table

Question

Doxygen prints text instead of the expected table. File Text:

/*! \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      |
*/

HTML output from table:

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

This is the tilde symbol that causes the problem, after removing it, the table was displayed as expected.

Is this a bug or a special function?

Answer 1

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

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

instead

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