Doxygen无法创建Markdown表格。

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    |

问题出在波浪线符号上，删除它后，表格按预期输出。

这是一个bug还是特殊功能？

- Jeremy Royston

---

问题已在Doxygen邮件列表上得到处理，Jeremy也给出了答案： 我正在使用版本为1.8.5的Doxygen，并启用了MARKDOWN_SUPPORT=YES。 在设置Doxygen工厂默认值后，表格正确显示了 - 非常奇怪！ 我建议关闭此问题，并在可以重现时再次报告。 - albert

这对我来说完全没问题——是否带有第一列垂直条—使用 doxygen 1.8.1。请注意，当您省略右侧的垂直条并且最后一列中的一个字段为空时（这与没有最后一列相同），您确实不会得到表（当不是每行具有相同数量的列时，输出将失败）。 - Carlo Wood

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      |

- Bulletmagnet