title: How do I put blocks of PHP code into a PHPDoc DocBlock
body: <p>I'm playing around with PHPDoc and have realised that you can use markdown to add some formatting to a DocBlock. In particular, I notice that you can use back ticks to highlight inline code.</p>
  
  <p>However, I can't seem to figure out how to add blocks of code to a DocBlock, as using 4 spaces doesn't seem to work.</p>
  
  <p>I've tried using <code>&lt;code&gt;</code> and <code>&lt;pre&gt;</code> too, and whilst those tags do appear in the generated documentation, the code inside them becomes commented out with HTML comments.</p>
  
  <p>For example, this DocBlock:</p>
  
  <pre><code>/**
   * This is a test DocBlock
   *
   * &lt;pre&gt;
   *     &lt;?php
   *         echo('hi');
   *     ?&gt;
   * &lt;/pre&gt;
   *
   * @return object[] An array of objects.
   */
  </code></pre>
  
  <p>Generates this HTML:</p>
  
  <pre><code>&lt;pre&gt;
      &lt;!--?php echo('hi'); ?--&gt;
  &lt;/pre&gt;
  </code></pre>
  
  <p>Where am I going wrong? How can I add a block of code to my DocBlock?</p>