The only problem with mermaid that GitHub UI renders it poorly. Large diagrams very difficult to view. Any solution for that?
rdwrrr 16 hours ago [-]
Thanks for dropping this here.
I have been frustrated for quite some time.
I blindly followed the advice to learn some mermaid. Then I discovered that the ecosystem absolutely sucks.
hackthemack 19 hours ago [-]
Question for mermaid users out there. I have not used mermaid more than just superficially looking at it but it looks to me like a re-implementation of graphviz? Which has been around forever. Is there something it does that makes it more appealing?
I am not knocking this Free Mermaid Diagram Editor either. Seems decent. But, similarly, edotor has been around forever.
Mermaid has become the de facto charting language when working with AI, so it has been elevated to the chosen one, like Python.
qn9n 11 hours ago [-]
It also renders on GitHub in markdown files with ```mermaid``` code blocks so it's super useful for adding architecture diagrams and similar to your README
dTal 12 hours ago [-]
It does more types of charts, including Gantt charts. Very useful.
BLKNSLVR 20 hours ago [-]
Handy.
I've been (very loosely) trying to get AI to generate diagrams for a while, and even Copilot can't get Visio's file format correct enough to allow Visio to open it successfully.
This is a nice clean interface I can just paste attempts into. Thank you!
FailMore 9 hours ago [-]
I created https://smalldocs.org to help with this. After installing you can tell your agent to "sdoc me a mermaid diagram of X flow" or "sdoc me a visual architecture of this repo" or something, and it handles it nicely (imo!).
I am not knocking this Free Mermaid Diagram Editor either. Seems decent. But, similarly, edotor has been around forever.
https://edotor.net/
I've been (very loosely) trying to get AI to generate diagrams for a while, and even Copilot can't get Visio's file format correct enough to allow Visio to open it successfully.
This is a nice clean interface I can just paste attempts into. Thank you!
Here is the mermaid diagram gallery: https://smalldocs.org/s/PpArByXuNBA5kGS1JVMUW6#k=uTqNRLqzz_T...
Code available: https://github.com/espressoplease/smalldocs
Discord: https://discord.gg/txjATTsDaq
There is an art to designing the human to human communication aspect of diagrams that transcends which lines connect where.
Shout out to Kroki, which offers Mermaid and many other text-based diagramming formats.