It should be easy to add diagrams to your Markdown documentation. There are many solutions that can render diagrams inside Markdown; for example, see Asciidoctor.

However, if you want to add a custom diagram, it can be tedious to implement. Core idea: If you have a function that can produce a diagram as SVG, it should be trivial to use it in Astro (or other SSGs that use remark/rehype).

It should be easy to create documentation with many diagrams, like in Byrne's Elements of Euclid.

I have implemented core packages and added some examples. However, I still need to add more tests, and address the remaining TODOs.

Ideas for other diagrams: Text to Diagram.

• @beoe/rehype-code-hook
• @beoe/sqlitecache
• @beoe/cache
• @beoe/remark-code-hook
• @beoe/pan-zoom
• @beoe/fenceparser
• docs Netlify Status

The logo is an illustration from Oliver Byrne's Elements of Euclid: The First Six Books with Coloured Diagrams and Symbols.