Admonitions and other improvements to markdown documentation
Created by: seancolsen
Most notably, this PR adds (and documents) support for admonitions, you know... those little break-out boxes like "Note", "Warning", etc. and this change should close #36 (closed)
Other smaller tidy stuff included as well, but nothing too major.