doc: more markdown improvements

Signed-off-by: David Scott <dave.scott@citrix.com>