enable markdown parsing in JSDoc and add newlines to ensure proper parsing of lists

Using Github Flavored Markdown without "hardwrap" ( http://usejsdoc.org/plugins-markdown.html#github-flavored-markdown )