doc: correct some pandoc sub-optimalities

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