如何在Dokka中创建嵌套列表？

Question

试图用一个非常常规的结构来记录一些Kotlin代码:

1. 编号列表.
   • 带有项目符号子列表.
2. 数字在列表的顶层正确继续的位置.

我所采取的官方Dokka页面甚至没有页面上的"列表"一词.谷歌搜索没有找到任何关于如何做到这一点的信息.救命!

Answer 1

据我所知,嵌套四个空格的额外缩进有效:

/**
 * 1. A numbered list.
 *     * With a bulleted sublist.
 * 1. Where the numbers continue correctly at the top level of the list.
 */
val foo: Int = 0

结果是:

Answer 2

Dokka 使用 markdown，它有一些分支和风格，根本没有标准化，但这是有效的：

/**
 * list:
 * - item1
 * - item2
 *
 * numbered:
 * 1. one
 * 2. two
 */