The Power of Markdown

Would you be open to keeping all project documents in Markdown format?

I've observed that it is very beneficial.

• You can create documents in any Markdown file editor and store them in any SCM repository used in the project.
• You can review the doc changes in a code review tool.
• You can see the difference between revisions.
• You can create baselines, maintain several product versions in parallel, and merge them into a single mainline.

Everything you need for the document control is already created for the code. The price is to learn how simple the Markdown syntax is.

You can even convert Markdown files to docx or pdf format if needed.

Isn't this a miracle?