Sooner or later when creating software you end up drawing diagrams to explain how the system you are building works. This post is a short primer to Mermaid, a tool for creating and maintaining diagrams, with personal insights.