Add support for mermaid diagrams in generated documentation

[Notgnoshi]

My preference is to use the approach outlined in mersinvald/aquamarine#20 because then mermaid diagrams get rendered in markdown documents in both GitHub and the generated docs.