A nice article on adding diagrams to markdown documents is here

The article demostates how to use Jamal to integrate MermaidJS in markdown documents. This approach also works for other diagramming tools as well.