Animated Mermaid Diagrams: Make Them Move, Then Share Them as a GIF

Animate any Mermaid diagram in Prisment — packets along every arrow, colour that follows the flow — then share it as a looping GIF, made on your device.

Animated Mermaid Diagrams: Make Them Move, Then Share Them as a GIF

Prisment 2.0.0 makes Mermaid diagrams move. Small packets travel along every arrow, so anyone can see at a glance which way things flow. Restyle a diagram in one click, and when it looks right, share it as a looping GIF — made on your device, with nothing uploaded.

The animation at the top of this page is one of those GIFs, made by Prisment from an ordinary Mermaid flowchart.

1. A new look in one click

One Customize button beside the zoom controls restyles any diagram — themes for light and dark pages, colour that follows the flow, a hand-drawn sketch style, rounded boxes and tidy right-angled lines — and sets it moving.

The Customize panel open beside a colourful checkout flowchart, on its Colour tab: themes Stock, Indigo, Ultraviolet, Cobalt, Jade, Copper and Fuchsia, each shown as its range of colours; Spectrum set to Flow; Fill and Glow; and at its foot, Changed — not saved in the file with a Reset link and a small arrow beside it, then Save for all diagrams, Save here and New diagram file on one line ending in a warning mark, and Share as GIF.

Your Mermaid text never changes: the look is drawn on top of it, and the panel only offers what suits the diagram in front of you. The user guide lists every option.

An animated state diagram of an order, sketched by hand in warm orange to red: Placed, Paid, Packed, Shipped and Delivered, with Refunded and Cancelled branching off, and short fading streaks moving along every transition.
The same controls, a different mood — Hand-drawn, with streaks.

2. Diagrams that show which way things go

Turn on motion and every arrow carries traffic, from where it starts to where it points — a flowchart reads as a flow, and a sequence diagram as messages on their way. Pick the kind of movement that fits your diagram:

  • Packets — dots travelling each line
  • Streaks — dots with a fading tail
  • Current — a steady stream of dashes
  • Signal — a bright pulse, one message at a time
An animated sequence diagram of an online payment: Customer, Web app, Payments and Bank, each in its own colour, with a short bright signal moving along each of the six numbered messages, from Place the order to Order confirmed.
A payment, message by message — Signal, with every participant in its own colour.

You set the speed and how busy the lines are, a pause button sits beside the diagram, and if your system asks for less motion, diagrams stay still.

3. Colour that means something

Prisment is named after a prism, and Spectrum brings the idea to your diagrams: each box takes its colour from where it stands in the flow, so the colour itself tells you how far along you are.

Two ways Spectrum colours a diagram. Flow: the boxes App, API, Orders, Billing and Ledger shift from teal through blue and violet to pink along the flow, each line blending between them. Mosaic: every box in its own distinct colour, with neutral lines.

Prefer every box to stand out on its own? Mosaic gives each one a colour of its own instead.

4. Share it as a GIF

Press Share as GIF, pick a frame, and save: you get a looping GIF of the diagram as you styled it, ready for LinkedIn, a README or a chat — made in your browser, with no watermark.

  1. Give your diagram a motion in its Customize panel.
  2. Press Share as GIF.
  3. Pick a frame — the diagram's own shape, square, portrait or 16:9 landscape.
  4. Press Save GIF.

The Share as GIF dialog making this page's hero: a preview of the looping GIF with a thin outline marking the edge of the Landscape frame, 1920 × 1080 · 60 frames · 447 KB, the Landscape frame and a 3-second loop selected, and Save GIF.

The loop joins up with no visible jump, and the file stays small enough to post. A diagram that doesn't move can be saved as a PNG or SVG picture instead.

5. Walk your team through it

For presenting, Reveal builds a diagram in reading order, Trace lights up the path through the box you point at, and the presentation button plays a sequence diagram one message per click, on the page or in fullscreen. A busy diagram becomes a story you can tell one step at a time.

6. The look travels with the file

Save a diagram as a .mmd file and it keeps its look: your choices sit in a few readable lines at the top of the file, which Mermaid itself simply ignores.

---
prisment:
  look: neo
  spectrum: on
  motion: packets
---
flowchart TD
  push[Commit pushed] --> build[Build]

The file still opens in any Mermaid tool. And when you find a look you love, Save for all diagrams makes it your default everywhere.

7. Works wherever your diagrams are

Diagrams move in the Prisment workspace, in the browser or the desktop app, in the HTML pages you export, and right here. The one below is live — press Customize on it, or pause it.

Charts without arrows, such as pie and Gantt charts, get the themes but not the motion.

8. Try it

Open any Mermaid diagram in Prisment and press Customize — start from an animated diagram, already moving, bring your own to the Mermaid editor, or use the desktop app. All free, with no account.

Every option — each motion, theme and style, and every frame a GIF can take — is described in the user guide. Your diagrams stay on your device; the website itself uses analytics, as the privacy policy explains.

Frequently asked questions

How do I animate a Mermaid diagram?
Open the diagram in Prisment — a Mermaid block in a Markdown document, or a .mmd file — press Customize beside its zoom buttons and choose a motion: Packets, Streaks, Current or Signal. Small marks then travel every arrow from where it starts to where it points. Prisment is free and runs in your browser or as a desktop app.
Can I turn a Mermaid diagram into a GIF?
Yes. Give the diagram a motion in Prisment, then press Share as GIF in its Customize panel, pick a frame — its own shape, square, portrait or 16:9 landscape — and save. The GIF loops without a visible jump, is made on your device, and carries no watermark.
Does animating a diagram change my Mermaid code?
No. The motion and the look are drawn on top of your diagram, and your Mermaid text stays exactly as you wrote it. Only when you ask a .mmd file to keep its look does Prisment add a few lines to its front matter, which Mermaid itself ignores.
Which Mermaid diagrams can be animated?
Every diagram with arrows: flowcharts and sequence, class, state, entity–relationship, requirement, mind map, block and architecture diagrams. Charts without arrows, such as pie, Gantt and timeline charts, take the themes but not the motion.
Can I pause the animation?
Yes. A pause button appears beside Customize whenever a diagram moves, and diagrams scrolled out of sight pause by themselves. If your system asks for reduced motion, diagrams stay still until you turn motion on.