improve docs, markdown extensions

Hi,

after #1357 and other similar inquiries I looked through the documentation and except for the setting `MD_EXTENSIONS` itself there is no talk about that extensions for python markdown exist or are supported. I quickly added a simple sentence to the docs to hopefully steer people the right way.

Thoughts on that? Should we maybe even include a whole section for this?