Diagrams

[AlexHedley]

Mermaid

Could use the inbuilt mechanism from Just The Docs

#30 (comment)

Another thing: does mermaid do offline rendering? We'd definitely want pre-rendered SVGs, no javascript at runtime. Same would go for mathjax - it is runtime by default, should be offline pre-rendered.

Alternative

https://github.com/mermaid-js/mermaid-cli

Doc writer could save the .mmd in a folder like the affinity file so there's a reference to use, then generate the image locally, add that to the images folder and reference as usual.

This could also be made into a build step, but maybe not worth the effort, yet.

e.g. Using Mermaid diagrams with Statiq.