> Please don’t write your documentation in Markdown. Please. I’m begging you.

> Markdown is tolerable for short documentation, like a readme.md. Past that, it’s the wrong tool for the job.

A very good #rant about markdown issues. Provides several solutions as well.

#docops