Explore implementation of Mermaid diagrams via design doc

[petele]

Add support for mermaid style diagrams in Markdown, similar to what GitHub has done https://github.blog/2022-02-14-include-diagrams-markdown-files-mermaid/

[jpmedley]

This looks cool. Can we control the look and feel of the diagrams through CSS?

[jeffposnick]

For future reference: there is https://github.com/KevinGimbel/eleventy-plugin-mermaid, but that requires adding JavaScript to your pages to render the diagram at runtime.

I can't find a 11ty-specific package that renders the diagrams as SVG at build time and includes a mechanism for injecting the local SVG image onto the page.

[matthiasrohmer]

As a first step we want to see if there are existing open source Node.js libraries that render Mermaid diagrams and how we then could add those diagrams to our documents. The lib needs to be quick and ideally doesn't produce extra files but renders SVGs or HTML and doesn't rely on client-side rendering. Research and possible implementation notes should go in a design doc.

[mollietokyo]

spoke with Matthias, he's waiting on internal updates prior to marking this one as 'done'

[matthiasrohmer]

We will not pursue this for now.