slides VS asciiflow

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

> 7. You can put them in the source where they are relevant.

> Got a hairy state machine? Stick a comment at the top with something like nomnoml's syntax and anyone can follow what's going on without having to trace through the code.

For that use-case a markup graph language is a poor solution. Use https://asciiflow.com instead to produce something that people can digest without needing a third-party tool that may not even exist anymore.

Many diagrams I am able to draw manually as I'm editing source code on emacs, but for more complicated ones I tend to use this: https://asciiflow.com . To each their own, so pick your favorite ASCII editor.

This isn't at all what you are asking for but I use it in code all the time for flow-charting logic. https://asciiflow.com/ And on the plus side, the output is very portable.

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

So I used this website: https://asciiflow.com to draw out the diagrams and then pasted them into the LCDs using the monospace font! An LCD is 39x58 "ASCII tiles" FYI if you wanted to do this too!

AsciiFlow