Estoy jugando con PHPDoc y me he dado cuenta de que puedes usar markdown para agregar algo de formato a un DocBlock. En particular, me doy cuenta de que puede usar marcas anteriores para resaltar el código en línea.

Sin embargo, no puedo encontrar la forma de agregar bloques de código a un DocBlock, ya que el uso de 4 espacios no parece funcionar.

He intentado usar<code> y<pre> también, y mientras esas etiquetas aparecen en la documentación generada, el código dentro de ellas se comenta con comentarios HTML.

Por ejemplo, este DocBlock:

/**
 * This is a test DocBlock
 *
 * <pre>
 *     <?php
 *         echo('hi');
 *     ?>
 * </pre>
 *
 * @return object[] An array of objects.
 */

Genera este HTML:

<pre>
    <!--?php echo('hi'); ?-->
</pre>

¿A dónde me voy mal? ¿Cómo puedo agregar un bloque de código a mi DocBlock?