Merge branch 'ReadabilityOfContributingDoc' into 'master'

Extension for markdown should improve readability

It was hard to read this online.  This should enable links where
appropriate.

Unfortunately, I am not positive that this won't break some tool relying on the filename not having an extension.

See merge request !771