documentation - KDoc：插入代码片段

Question

如何在 Kotlin 的默认文档工具 KDoc 中插入代码片段？

在 Java 中，我可以使用以下内容：

/**
 * Example usage:
 *
 * <pre>
 * <code>&#64;JavaAnnotation
 * public void foo() {
 *     // Code
 * }
 * </code>
 * </pre>
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface JavaAnnotation {}

Kotlin 中似乎没有等价物。我尝试使用 Markdown，但在行尾后插入 2 个空格不会换行。

Answer 1

您可以使用三个反引号：

/**
 * Example usage:
 *
 * ```
 * @JavaAnnotation
 * public void foo() {
 *     // Code
 * }
 * ```
 */