How to Use Mermaid in Microsoft Loop Easily 2026

Click onto an empty line in your Loop page and type the slash command for Mermaid, which swaps that line for a code entry module instead of a plain text block. This is the same slash-command pattern Loop uses for tables, images, and other structured content, so it feels familiar once you've used it once. The block opens with a language selector already set — visible in the corner of the module — confirming you're in a Mermaid-aware code block rather than a generic one.

A minimal flowchart starts with a direction declaration like flowchart TD for top-down, followed by node definitions and arrows on the next lines. Something as short as A[Need Diagrams?] -->|use| B[Mermaid] defines two labeled boxes and an arrow between them tagged with the word "use" — three lines of plain text producing a fully rendered flowchart with no drawing involved. Node names on the left of the brackets (A, B) are just internal identifiers; the text inside the brackets is what actually shows up in the box, so you can rename labels freely without breaking the connections between them.

Loop renders the Mermaid block as a code editor on top with line numbers down the left side, and the compiled diagram appears directly underneath it in the same container, with small toolbar icons and a language dropdown along the top edge for managing the block. This means you don't have to hunt for a separate preview pane — editing the code and watching the shape change happen in the same visual space, which makes it easy to iterate on a diagram by trial and error. Scrolling the page keeps both the code and its rendered output together as one unit rather than splitting them apart.

Once the basic two-box flowchart works, add more lines following the same pattern — another node definition and arrow per line — to build out a longer process. Mermaid also supports other diagram types beyond flowcharts, including sequence diagrams for showing interactions over time and Gantt charts for timelines, all written with their own similarly compact syntax. Because everything is plain text, restructuring a diagram is just editing lines rather than dragging shapes around a canvas, which is faster once you're comfortable with the syntax.

Because the diagram lives as an actual code block on a shared Loop page rather than an exported image, any teammate with edit access can open it and change a label, add a branch, or fix a typo directly in the syntax. The rendered diagram updates immediately for whoever is looking at the page, without anyone needing to re-export or re-upload anything. This is the real advantage over a diagram built in external drawing software — the source and the visual are the same object, so they can never drift out of sync.