I couldn't disagree more, every ounce of friction that you add to the process of writing documentation is dozens if not hundreds of documents that could have been written and are not going to be.

Unless of course there's a good reason for maintaining your docs in markdown files, but all of them?