we probably need to unify the markdown rendering logic (notwithstanding the face that docs get twoslashed)