On: Include diagrams in your Markdown files with Merma...

[OJFord]

I strongly disagree with that, they're about as clear and unintrusive as I can imagine, what else would you do?

Personally _I_ even sometimes use them when markdown isn't available, as in won't be rendered.