In this inaugural episode of Learning the Dots, Alex and Morgan introduce Mermaid.js, an open-source tool that lets you create diagrams using simple text instead of drag-and-drop editors. The conversation focuses on how diagrams-as-code work, why they matter for modern teams, and how tools like Mermaid fit naturally into documentation, collaboration, and version-controlled workflows.

What Is Mermaid.js?

Mermaid.js is a lightweight, open-source diagramming tool that converts plain text into visual diagrams such as flowcharts, sequence diagrams, and class diagrams. By treating diagrams like code, Mermaid makes documentation easier to maintain, review, and share.

Why Diagrams as Code Matter

The hosts explain how traditional diagramming tools often fall out of sync with reality. Mermaid.js solves this ...