Built-in markup
For inline markup, KDoc uses the regular Markdown syntax, extended to support shorthand syntax for binding to other code elements.
Link to items
To refer to another element (class, method, property or parameter) just put your name in square brackets:
Use the [foo] method for this.
If you want to specify a custom label for the link, use the Markdown link style syntax:
Use [this method][foo] for this purpose. You can also use names in links. Note that, unlike JavaDoc, qualified names always use the dot character to separate components, even before the Name method:
Use [kotlin.reflect.KClass.properties] to list the properties of a class. Names in links are resolved using the same rules as the name was used inside the documented element. In particular, this means that if you imported a name into the current file, you do not need to fully qualify it when you use it in a KDoc comment.
Note that KDoc does not have syntax to allow overloading members in links. Since the Kotlin documentation generation tool puts documentation for all function overloads on the same page, the definition of a specific overloaded function is not required to link to work.