Markdeep has some very nice features. I love to be able to have more expressiveness than in regular markdown.
But I am not so sure about the diagramming feature. Writing diagrams as ascii art seems like a PITA to me, especially when you need to update a diagram with new shapes, etc.
Last time I had to embed diagrams I used mermaid js https://mermaid-js.github.io/mermaid/#/ which is made to be rendered alongside markdown. Not sure if your particular diagram is supported but the project has a big community around it so there should be a way.
Not like the example you've given, but for well designed and easy to configure diagrams that can be saved or exported in plain text (e.g. for use in documentation, websites or markdown) I use Monodraw: https://monodraw.helftone.com
For graphical diagrams I use yEd or occasionally draw.io for quick and simple graphical flow charts (online or offline as a gross javascript web frame - but it works well enough and it's free).
I use Monodraw[1] on my Mac, I really like it because it's ascii rather than image or vector based which makes including the diagrams in markdown really easy.
It also has a really simple UI that allows me to quickly map out my thoughts so I use it for a lot of things.
I use Markdown Plus. It has a plugin (mermaid) that lets you write some graphs and sequence diagrams in markdown. I find it easier to make updates to diagrams this way. It doesn't make the most beautiful renderings, but works pretty well for me.
I love the open source diagrams.com (previously draw.io). I save the files as editable SVG so I can include them directly in markdown READMEs. I use diagrams both to help me design and to show during demos
https://draw.io
But dbdiagram.io looks amazingly easy to use.
And so are the rest of the suggestions.
I also realize that I don't use UML with draw.io:)
I've always automated my Markdeep[1] documentation's inline PlantUML diagrams with a few scripts here and there (simply looks for .puml files, exports PNG and SVG and hosts everything on a static site), but I've never imagined using a service for supplying the generated output. I want to bounce off this idea somehow.
reply