Render Mermaid diagrams as SVGs or ASCII art

(github.com)

83 points | by mellosouls 2 hours ago

12 comments

  • peanutz454 0 minutes ago
    I get a sense of deja vu. There was another such project posted within the last 3 months, and another within last 6 months. I should have bookmarked them, because at least one of them was an open library (I think).
  • tempaccsoz5 27 minutes ago
    The actual Mermaid ASCII renderer is from another project [0]. This project transliterated it to typescript and added their own theming.

    [0]: https://github.com/AlexanderGrooff/mermaid-ascii

  • lubujackson 1 minute ago
    This is great, I will definitely make use of this!
  • jonfw 1 hour ago
    I love ASCII diagrams! The fact that I can write a diagram that looks equally wonderful in my terminal via cat as it does rendered on my website is incredible.

    A good monospaced font and they can look really sharp!

    I will definitely give this tool a shot.

    I will also shout out monodraw as a really nice little application for building generic ASCII diagrams- https://monodraw.helftone.com/

  • rahimnathwani 32 minutes ago
    Wow! It has this:

      Subgraph Direction Override: Using direction LR inside a subgraph while the outer graph flows TD.
    
    With this, you should be able to approximate swim lane diagrams, which is something Mermaid lacks.

    The last time I checked, Mermaid couldn't render subgraphs in a different direction than the overall graph.

  • doanbactam 19 minutes ago
    I've had issues with other CLI wrappers there. ASCII output is a nice touch for including diagrams directly in code comments without breaking formatting. Does it handle large graphs well, or does the text wrap get messy? We tried using `graph-easy` for this before but the syntax was annoying. 6.
  • a_t48 1 hour ago
    The live demo requires some download of an AI agent platform? I'd really like to try this but not if that's what's required.
    • csmantle 49 minutes ago
      The devs should really setup a client-only GitHub Pages for an accessible demo. Judging from skimming the project itself, it's definitely doable without locking into their platform.
  • dleeftink 1 hour ago
    Pair this with Unicode plots[0] and you're set!

    [0]: https://github.com/JuliaPlots/UnicodePlots.jl

  • wyes 44 minutes ago
    How is the LaTeX compatibility? Base mermaid's LaTeX compatibility is quite sparse.
  • jackconsidine 1 hour ago
    > Aesthetics — Might be personal preference, but wished they looked more professional

    Im sold. Love mermaid but totally agree.

  • cjlm 36 minutes ago
    See also graph-easy.online (https://github.com/cjlm/graph-easy-online)