I am working on a project where all documentation is in markdown and plantuml for precisely these reasons, and honestly I'm surprised at how seamless the transi

I am working on a project where all documentation is in markdown and plantuml for precisely these reasons, and honestly I'm surprised at how seamless the transition has been from the usual world of Word docs plus ad-hoc diagramming tools (cough PowerPoint cough). Easy diffability is another big benefit.