Include diagrams in your Markdown files with Mermaid
I think so-called ASCII-art is more in the spirit of Markdown.<p>The nice thing about the original Markdown (modulo bugs) is that things are written the way one would write plaintext documents which are supposed to be easily read in a text editor.  So you don’t write bullet lists like this:<p>- Bullet 1 - Bullet 2 - Bullet 3<p>And hope that some post-processing will add linebreaks for you.  You write it like this:<p>- Bullet 1<p>- Bullet 2<p>- Bullet 3<p>Similarily there have been many tools that let you add so-called ASCII-art diagrams to Markdown documents.<p>The spirit behind the kind of thing in the OP, on the other hand, is that one should get nicely formatted HTML from Markdown for the purpose of online consumption.  Which is a very different goal.<p>So if I were to judge the syntax itself (since that is what matters most to the original spirit of Markdown.pl) I would say that it seems pretty decent.  Not as “declarative” (!) as ASCII-art, but most probably much easier to edit.