Updates to markdown help doc.

To clarify some ambiguous bits and also fix #21