update markdown so pandoc can generate valid rst