·Audun Martinussen

Mermaid vs BPMN 2.0 — hva er forskjellen og når bruker du hva

Mermaid har eksplodert i popularitet de siste årene. Men er det et reelt alternativ til BPMN for prosess-dokumentasjon? Her er en pragmatisk sammenligning.

Mermaid er en open-source diagrammeringsspråk som har eksplodert i popularitet de siste årene, særlig blant utviklere og tekniske team. Det støttes nå i GitHub, Notion, Obsidian, mange Markdown-editorer, og er innebygd i mange AI-genererte løsninger.

BPMN 2.0 er den etablerte standarden for forretningsprosesser. Den er bygd for det, har internasjonal støtte, og brukes i alle moderne prosess-verktøy.

Spørsmålet vi får ofte: "Kan vi bruke Mermaid i stedet for BPMN?" Svaret er nyansert — det kommer an på hva du skal med diagrammet. Denne artikkelen er en pragmatisk sammenligning.

Hva Mermaid er

Mermaid er et tekstbasert diagrammeringsspråk. Du skriver kode som denne:

flowchart TD
    A[Faktura mottatt] --> B{Treff på bestilling?}
    B -->|Ja| C[Sjekk varemottak]
    B -->|Nei| D[Avvis]
    C --> E[Bokfør]

Og du får ut et flytdiagram. Det er enkelt, og den tekstbaserte tilnærmingen gjør det ideelt for versjons-kontroll og embedding i dokumentasjon.

Mermaid støtter mange typer diagrammer: flowchart, sekvensdiagram, klassediagram, state diagram, gantt-diagram, ER-diagram, og fler. For prosess-modellering brukes typisk flowchart eller sekvensdiagram.

Hva BPMN 2.0 er

BPMN er en formell standard fra OMG (Object Management Group). For en innføring, se artikkelen om BPMN 2.0. Kort: det er en grafisk notasjon med tydelig semantikk for aktiviteter, hendelser, gateways, pools og lanes, lagret som XML.

Direkte sammenligning

EgenskapMermaidBPMN 2.0
NotasjonForenklet flowchartRik, standardisert
SemantikkBegrensetPresis
Pools/lanesBegrenset støtteInnebygd
Gateway-typerXOR (default)XOR, AND, OR, complex
EventerFå typer50+ typer
FormatTekst (Mermaid syntax)XML
Verktøy-støtteMarkdown, GitHub, NotionARIS, Signavio, Camunda, Bizagi
LæringskurveLavMiddels
Egnet forLette diagram, tekniske flyterForretningsprosesser, revisjon

Når Mermaid er riktig valg

Mermaid passer godt når:

1. Diagrammet skal leve i dokumentasjonen

Hvis du dokumenterer i Markdown — README-er, intern wiki, blog, eller dokumentasjons-sider som bygges som statiske HTML — er Mermaid praktisk fordi det renderes direkte i kilden. Ingen separat fil for diagrammet.

2. Tekniske flyter

For sekvensdiagram, state machines, data flow, system arkitektur — Mermaid er ofte god nok eller bedre enn BPMN.

3. Hurtig kommunikasjon

Hvis du vil tegne en flyt fort som del av en diskusjon, og det ikke trenger å være formelt korrekt, er Mermaid kjapt og lest.

4. Versjons-kontroll matters

Fordi Mermaid er tekstbasert, kan du versjons-kontrollere det i git uten merge-konflikter. BPMN-XML er teknisk versjons-kontrollerbart, men endringer i layout gir store XML-diff-er.

Når BPMN er riktig valg

BPMN passer når:

1. Revisjon eller compliance

Hvis dokumentasjonen skal brukes i revisjon (etter ISA 315 eller andre standarder), i ISO 9001-sammenheng, eller for tilsynsrapportering, er BPMN forventet. Det er det revisor og tilsyn er vant til.

2. System-integratorer

Hvis dokumentasjonen skal brukes av en ERP- eller integrasjons-konsulent, foretrekker de typisk BPMN-XML som kan importeres i deres verktøy.

3. Kompleks parallell-modellering

Når en prosess har parallelle løp, fork/join, eller flere typer hendelser, gir BPMN tydeligere semantikk enn Mermaid.

4. Roller og ansvarsfordeling

Pools og lanes i BPMN gjør det åpenbart hvem som gjør hva. Det er kritisk for segregering av oppgaver og kontroller. Mermaid har subgraphs som likner, men er ikke like uttrykksfullt.

5. Industristandard nødvendig

Hvis du har gjort kontrakter eller har komiteer som forventer BPMN, har du ikke valget.

Praktiske eksempler

Eksempel 1: Onboarding av nyansatt

For en HR-prosess som "onboarding av nyansatt" kan Mermaid være helt grei:

flowchart TD
    A[Kontrakt signert] --> B[Bestill utstyr]
    B --> C[Opprett tilganger]
    C --> D[Send velkomstpakke]
    D --> E[Første-dag agenda]
    E --> F[1-uke check-in]
    F --> G[30-dagers samtale]

Det er enkelt, lest, og fungerer.

Eksempel 2: Faktura-godkjenning

For en P2P-prosess som skal vises til revisor, er BPMN bedre fordi:

  • Lanes gjør det åpenbart at innkjøper, regnskap og leder er forskjellige roller
  • Gateway-merking er presis (XOR vs AND)
  • Eventer kan beskrive ulike triggere (tidsutløst, melding fra leverandør, feil)

BPMN-formatet sender et signal om at dokumentasjonen er bygd for formålet — det er en uoffisiell tegn på modenhet.

Hva vi bruker i NorthControl-leveranser

Vi leverer typisk i begge formater:

  1. BPMN-XML som hovedleveranse — for import i ARIS, Signavio, Camunda eller andre verktøy klienten bruker
  2. PNG-eksport av BPMN for raske visninger
  3. Mermaid-versjon når klienten ønsker å embedde i intern Markdown-dokumentasjon
  4. Narrativ tekst som forklarer prosessen i prosa

Klienten eier alle formatene og kan redigere i hvilken som helst. For mer om vår tilnærming, se eksempel-leveransen eller pakkene.

En vanlig misforståelse

Mermaid markedsføres noen ganger som "modernere" enn BPMN. Det stemmer i den forstand at det er nyere, men det er ikke et erstatning. BPMN er bygd for forretningsprosesser med all den semantikken det krever. Mermaid er et generalist-verktøy for diagrammer.

Sammenligning er litt som å sammenligne JavaScript med Python. Begge er nyttige; de er bare designet for forskjellige formål.

Hva du bør gjøre

For en SMB som vurderer hvilket verktøy:

  1. Hvis du er primært tekniske team eller utvikler-driver, og diagrammene lever i intern dokumentasjon: bruk Mermaid for det meste.
  1. Hvis du har revisjon, compliance, eller forretnings-prosess-fokus: bruk BPMN.
  1. Hvis du har begge: lever BPMN som hovedformat, og bruk Mermaid for intern eller "lett" dokumentasjon.

Oppsummering

Mermaid og BPMN er ikke konkurrenter i samme sjikt. Mermaid er et utviklervennlig verktøy for ulike typer diagram, mens BPMN er en spesialisert standard for forretningsprosesser. Velg basert på hvem som leser, hva formålet er, og hvor dokumentasjonen lever.

Hvis du er usikker — start med BPMN. Det er mer formelt, men det kommer aldri til å være feil valg for forretningsprosesser. Mermaid passer best som supplement, ikke som hovedformat for prosess-arbeid med formelle krav.

Vil du se hvordan vi dokumenterer prosesser i praksis?

Et komplett eksempel — innkjøp-til-betaling for en 80-personers grossist — er publisert med BPMN, kontroller og risikoer.