convert desc to markdown - updated api docs