svgbobrus VS spark-joy

I recently had to draw some diagrams for documenting something. After looking at various Markdown-friendly options I landed on svgbob[1]. I believe it's a superior solution to these kinds of graph drawing tools for Markdown for one specific reason: the code is still readable. When I go to look at a Markdown file I don't always open the output. I will commonly open up a README file in Vim or just cat it to the terminal. In this case diagrams like those in this post is next to useless. I'm not going to read through some complex drawing definitions and try to visualise the results. With svgbob (or Typograms[2] or any of the other similar options) you can still read the Markdown text document and see the diagrams which is great!

Of course this comes with a tradeoff, drawing the diagrams can be a bit of a pain. But I believe this can be solved by a good Markdown editor or editor plugin. Alternatively a spec like this could be converted into an svgbob-compatible diagram.

[1]https://ivanceras.github.io/svgbob-editor/

Online playground svgbob-editor is also updated to use the latest version of svgbob. It is however a painfully slow to edit the diagrams from there, so it's better if you draw the diagram somwhere else and paste it to there.

There’s Svgbob. Plus when it comes to more complex diagrams or graphs where creating the ASCII art by hand in can be quite finicky, there’s a number of tools (including drawing tools) to make creating ASCII art much easier.

https://ivanceras.github.io/svgbob-editor/

svgbob

Since the post contains ASCII art, let me recommend you svgbob :)

The app can now render Svgbob code blocks (https://ivanceras.github.io/svgbob-editor).

what about Excalidraw / TLDraw? there are so many of these canvas drawing apps[1]. draw on them, take a screenshot. doesnt export to svg but do people really need that?

[1]: https://github.com/swyxio/spark-joy/blob/master/README.md#ge...

ive been a keeping a list of other diagramming tools too https://github.com/swyxio/spark-joy/blob/master/README.md#di...

i've been keeping my own resource list for a few years: https://github.com/sw-yx/spark-joy/

just offering for anyone else interested!

i collect these for fun! adding to my collection https://github.com/sw-yx/spark-joy/blob/master/README.md#dro...

more like this:

  -  https://andybrewer.github.io/mvp/ mvp.css

my list of icon resources here: https://github.com/sw-yx/spark-joy/blob/master/README.md#ico...

ok this is a fantatsic solution. took me a while to get why this is better than joshwcomeau's solution, but now i am using this as my default.

(dont wanna seem too pluggy but just sharing my cumulative css notes: https://github.com/sw-yx/spark-joy/ i dont make money from this)