Doxygen 不创建降价表

Question

Doxygen 输出文本代替预期的表格。文件文本为：

/*! \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 输出为：

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

这是导致问题的波浪符号，省略它后，表格按预期输出。

这是错误还是特殊功能？

Answer 1

即使使用波浪号也适用于 Doxygen 1.8.5；但必须删除第一列竖线：

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

代替

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