Normalmente, temos um log de alterações em nossos DTOs Java, que consiste em uma tabela definida em Javadoc:

/**
 * ,Changelog:
 *
 * <table>
 *     <tr><th>Version</th><th>Description</th></tr>
 *     <tr>
 *         <td>2</td>
 *         <td>Added field 'something'</td>
 *     </tr>
 *     <tr>
 *         <td>3</td>
 *         <td>Added field 'somethingElse'</td>
 *     </tr>
 * </table>
 */
public class MyDTO {
 ...
}

Isso torna (no Intellij usando a visualização do Javadoc) algo parecido com isto:

Agora queremos fazer o mesmo para nossas classes de dados Kotlin. Lendo os documentos deKDoc onde diz:

Para marcação embutida, o KDoc usa a sintaxe Markdown regular, estendida para suportar uma sintaxe abreviada para vincular a outros elementos no código.

Então, eu tentei criar uma tabela usando a sintaxe do Markdown:

/**
 * Changelog:
 *
 *| Version       | Description                 |
 *| ------------- | --------------------------  |
 *| 2             | Added field 'something'     |
 *| 3             | Added field 'somethingElse' |
 *
 */
data class MyKotlinDTO(..) { 
    ...
}

Mas isso renderiza (novamente usando a visualização Intellij):

O que não parece uma mesa.

Também tentei usar apenas uma tabela HTML, mas isso também não funciona.

Pergunta, questão

O KDoc suporta tabelas e, em caso afirmativo, como você cria uma?