2.2.0: Links in the sublist doesn't get rendered

[bca111]

Describe the bug
Links in the sublist doesn't get rendered in the IDE + generated documentation

Expected behaviour
Links in the sublist to be rendered as in Dokka 1.9.0 with K1

Links are rendered correctly in commonmark.js dingus here

Screenshots
Screenshot from the IDE, with comment regarding the behavior

To Reproduce
Code block in the screenshot:

     /**
         * 1. *** Foo ***
         * 2. ** Bar **
         *
         *    (Required is lead by 4 spaces, proper sublist but links are not rendered)
         *    Required configuration properties:
         *    * [config1][Int]
         *    * [config2][Int]
         *
         *   (Required is lead by 3 spaces, renders everything in the same line, links rendered)
         *   Required configuration properties:
         *    * [config1][Int]
         *    * [config2][Int]
         *
         *
         *    (Bullet points led by 3 spaces, not rendered as a sublist but top level, links rendered)
         *    Required configuration properties:
         *   * [config1][Int]
         *   * [config2][Int]
         */
        fun foo(): Nothing = TODO()

Dokka configuration
2.2.0 with defaults (K2)

Installation

• Operating system: macOS
• Build tool: Maven
• Dokka version: 2.2.0

Additional context
Links are rendered correctly in commonmark.js dingus here

Even when I remove the bullet points and put the link as Required configuration properties [str][String]with the correct indentation (stay within 2nd point), links are not rendered.

[whyoleg]

Thanks for the report!
Those issues are, in reality, issues in the KDoc lexer/parser itself, and not in Dokka (that's why you see the same result in the IDE), similar to the ones in #3385, so I created them there:

• KT-85873 KDoc: Continuous indentation in lists
• KT-85867 KDoc: Leading whitespaces handling

---

Regarding why they stopped working in K2: it is because now we use stable Kotlin Analysis API to resolve links in KDoc, and so we now need that the output of KDoc lexer/parser is correct, while previously with K1 analysis, we used "compiler internals" and just scraped all the links in KDoc comment, potentially resolve even those links which should never be resolved.

Moving forward, if there are issues like this, which are reproduced in both IDEA and Dokka, it's best to create an issue in YT (https://youtrack.jetbrains.com/issues/KT). Thanks!