title: Doxygen does not create a markdown table
body: <p>Doxygen outputs text in place of the expected table. The file text is:</p>
  
  <pre><code>/*! \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      |
  */
  </code></pre>
  
  <p>The HTML output from the table is:</p>
  
  <pre><code>| Pin | I/O  | Function || --: | :--: | :------- ||  1  | I    |
  </code></pre>
  
  <p>It's the tilde symbol which causes the problem, after omitting it, the table was output as expected.</p>
  
  <p>Is this a bug or a special feature?</p>