more formatting fixes to generate a proper markdown ouput