Improved docs with more markup
improved docs on closing paragraphs