It shouldn't do - eg. the markdown renders just fine as it currently is in the REST framework docs.
(And also in the editor I use - Mou)

Could that be anything to do with quirks with your markdown editor?