It better reflects what the function actually does
Use a proper markdown parser to convert the text. This way more of the formatting is correctly removed.