[Kotlin/dokka] New comment by yole on pull request...

# dokka

[user]

[Kotlin/dokka] New comment by yole on pull request #83: many markdown fixes
This is unfortunately very hard to review in this form. Would it be possible to split this into multiple pull requests which change one thing at a time? I'll leave some comments for this PR according to what I can see in this version of the code.