4 ms·

Mermaid charts! Supported by github and very readable as plaintext https://github.blog/developer-skills/github/include-diagrams-markdown-files-mermaid/ https:/

• josephg 2y ago
  I put that in the "hacky workarounds" category. Does it work at all? Yeah. Does it work in my markdown editor? Probably not. Does it work in my markdown renderer? I don't know. Which version of Mermaid does it work with? Probably a different version of mermaid on every platform. Can I save my mermaid diagram to a file and link it instead of inlining the mermaid diagram inline? Who knows. Flip a coin everywhere mermaid is supported. I tried pushing a markdown renderer to the limits once - only to find out that the markdown renderer I was using doesn't correctly implement commonmark, and my markdown file breaks with every other markdown renderer I've tried it with. To say nothing of the custom extensions I tried to use. At this stage I'd rather keep my markdown files simple, and use something better for real documents. Something like typst.