Improve some parts of the README file

Explicitly reference Redcarpet::Markdown instead of Markdown object
which can be a bit confusing since this object should be here to provide
a compatibility layer with the old RedCloth API.

Also add a quick note about the nesting_level option which has been
introduced in #279.

[ci skip]