Beautiful Mermaid

Table of Contents

• Standards snapshot
• When to use
• When not to use
• Required inputs
• Deliverables
• Philosophy
• Workflow
• Verification
• Constraints
• Anti-patterns
• Remember

Standards snapshot (March 2026)

• Prefer deterministic local rendering over screenshots of random web renderers.
• Produce clean SVG first, then PNG only when requested or clearly useful.
• Treat Mermaid syntax validation as part of the workflow, not an afterthought.