doc: minor markdownlint cleanup and fixes to admonitions

[skip ci]

Signed-off-by: Joachim Wiberg <[email protected]>

Author: troglobit