Do Not Write Documentation in Markdown

Seems the web has a few “Don’t write documentation in Markdown” commentaries. Along with rebuttals.

Writing is a means of communication. The goal is to communicate.

The tool used is not the goal. Each person should use the tool that best helps communicate.

Markdown provides nominal structure while encouraging people to write.

Sounds reasonable to me.

Is markdown suitable for all writing projects? No, but probably is good enough for the intended user.

I don’t use Markdown to write this blog. I use plain text and a half dozen HTML tags. That works for me. For me, Markdown would be too much work.

Posted: April 09, 2020 Category: Usability Tagged: Tech Writing