svgbobrus VS slides

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).

Combination of: - http://maaslalani.com/slides/ - for slides - figlet/toilet/cowsay/lolcat - for generating titles and ascii art - https://github.com/lewish/asciiflow - for charts and diagrams

For those that are curious, I was using the `slides` CLI app to render the presentation via markdown https://github.com/maaslalani/slides

This is pretty neat!

I have playing around with using slides^1 before for doing small demos with my team, but I find that outside of highly technical geeks most people don't want to look at presentations in plain text in a terminal window. I like that this lets you create more graphical slides still using markdown + your favorite editor.

[1]: https://maaslalani.com/slides/

Most of the notes about the language are in an interactive readme with runnable code samples. It can be ran in 2 ways: - using nvim to evaluate code snippets inline using neovim with the mdeval plugin. Using FeMaco creates an editing floating window with rust-tools LSP attached and Treesitter attached. - using slides, an interactive terminal presentation tool

For presentations definitely check out another project of mine: https://github.com/maaslalani/slides

You could also use a presentation type tool (like tpp or slides) to practice around with?

https://github.com/maaslalani/slides came close but it only accepts one file, and the slides are split by --- inside of that file