Behöver ert företag hjälp med att implementera AI? Kontakta oss och få prisoffert här →
AI Skolan
January 22, 2026

GitHub + Mermaid.js: delbara diagram för team

Rickard Andersson Partner, Nodenordic.se

Du bygger automationer, och sedan tappar du tid på att förklara dem. Igen. Skärmdumpar blir snabbt inaktuella, diagram finns bara i någons huvud, och varje ”snabb granskning” blir ett möte.

Den här lösningen för delning av Mermaid-diagram träffar automationsbyggare först, men produktfokuserade teknikledare och även byråoperatörer märker det när överlämningar börjar glida. Utfallet är enkelt: en enda länk som renderar ditt n8n-workflow som ett läsbart flödesschema, så att folk kan granska det utan att öppna n8n.

Du får se hur workflowet förvandlar en n8n-webhookförfrågan till en interaktiv Mermaid.js-sida, och hur det valfritt kan hänvisa till GitHub som en reservkälla för workflow-JSON.

Så fungerar automationen

Här är hela workflowet som du kommer att sätta upp:

n8n Workflow Template: GitHub + Mermaid.js: delbara diagram för team

Varför detta spelar roll: att hålla workflow-dokumentation från att bli inaktuell

n8n är visuellt när du är inne i n8n. Problemet är alla andra. Så fort du behöver feedback, godkännande eller en överlämning är du tillbaka till att klistra in skärmdumpar i Slack, spela in skärmdelning eller skriva en doc som är fel nästa vecka. Och när ett workflow har grenar, villkor och några ”tillfälliga” noder blir det svårt att förstå utan att klicka runt. Den förvirringen kostar verklig tid: längre granskningar, mer fram och tillbaka och riskabla antaganden när någon uppdaterar automationen senare.

Det summerar sig snabbt.

  • Granskare ser inte den faktiska strukturen, så de godkänner ändringar baserat på bristande kontext.
  • Varje uppdatering tvingar dig att exportera igen, ta nya skärmdumpar och förklara på nytt vad som ändrats.
  • Grenar och ”om det här, då det där”-logik missas, vilket är där de flesta produktionsproblem gömmer sig.
  • Nya teammedlemmar tar längre tid att onboarda eftersom workflow-kartan är utspridd över flera verktyg.

Vad du bygger: en live Mermaid.js-diagramsida för n8n-workflows

Det här workflowet ger dig en lättviktig ”viewer” för dina n8n-workflows. Det startar med en webhookförfrågan (från din webbläsare, en doc-länk eller ett verktyg som Postman) och avgör sedan vad du vill ha: en lista med workflows eller ett enskilt workflows diagram. Om du begär en lista hämtar det workflows från din n8n-instans, formar om datan och serverar en responsiv dashboardsida byggd med Bootstrap 5. Om du begär ett workflow hämtar det JSON:en, konverterar noder och kopplingar till Mermaid-syntax (inklusive specialformer för olika nodtyper och styling för inaktiverade noder) och returnerar antingen Mermaid-utdata eller en renderad diagramsida. Valfritt kan du lägga till GitHub-backupplänkar så att en granskare kan hoppa till ”källan som gäller” om ditt team lagrar exporterad workflow-JSON i ett repo.

Workflowet börjar i en Incoming Webhook Trigger, routar förfrågan med en Switch och använder sedan n8n API-anrop för att hämta workflow-data. Ett kodsteg transformerar workflowet till Mermaid, och en sista responsnod returnerar antingen ett diagram eller en hel dashboardsida.

Vad du bygger

Förväntade resultat

Säg att ditt team granskar 5 workflows i veckan. Manuellt kan du lägga ungefär 20 minuter per workflow på att exportera JSON, ta skärmdumpar och skriva kontext (alltså runt 2 timmar per vecka), och ändå ställer granskare följdfrågor. Med det här workflowet skickar du i stället en länk till diagramsidan. Det tar några sekunder att dela, plus kanske en minut för workflowet att hämta och rendera, och folk kan självbetjäna strukturen utan att boka tid i din kalender.

Innan du börjar

  • n8n-instans (prova n8n Cloud gratis)
  • Alternativ för self-hosting om du föredrar det (Hostinger fungerar bra)
  • Webhook-åtkomst för att exponera diagram-endpointen säkert
  • GitHub om du vill ha valfria backupplänkar
  • n8n API-åtkomst (skapa en credential i n8n för n8n API-noder)

Svårighetsgrad: Medelnivå. Du konfigurerar credentials, uppdaterar ett par konfigfält och testar en webhook i webbläsaren.

Vill du att någon bygger detta åt dig? Prata med en automationsexpert (gratis 15-minuters konsultation).

Steg för steg

En webhookförfrågan kommer in. Du anropar en URL till din endpoint för ”diagramvisning”. Förfrågan kan innehålla en query (t.ex. vilket workflow du vill se), eller be om en dashboardlista.

Workflowet routar förfrågan. En Switch-nod (”Route by Query”) väljer mellan att hämta en workflow-lista eller att hämta ett enskilt workflow, så att en endpoint kan servera flera vyer utan att duplicera logik.

Workflow-data hämtas och formas. Om du ber om listan hämtar workflowet workflows, mappar om posterna till en prydlig dataset och konsoliderar rader så att dashboarden har allt den behöver. Om du ber om ett workflow hämtar det workflowet och förbereder JSON:en för diagramkonvertering.

Mermaid-utdata (eller en hel sida) returneras. En kodtransform gör om workflowet till Mermaid-diagramsyntax, och sedan serverar en ”Respond to Webhook”-nod antingen Mermaid-utdata eller en interaktiv webbsida som renderar den.

Du kan enkelt justera sidans styling och länkbeteende så att det matchar din interna dokumentation eller kundportal. Se hela implementationsguiden nedan för anpassningsalternativ.

Steg-för-steg-guide för implementation

Steg 1: Konfigurera webhook-triggern

Sätt upp arbetsflödets ingångspunkter så att ni kan rendera dashboardsidan eller hämta ett enskilt arbetsflödesdiagram.

  1. Lägg till Incoming Webhook Trigger och ställ in Path till dd9e2c5d-6c48-428e-aa54-bef9e369d3b0.
  2. Ställ in Response Mode till Respond to Webhook för att skjuta upp svaret till Deliver Dashboard Page eller Return Mermaid Output.
  3. Lägg till Manual Launch Trigger så att ni kan testa routning från editorn utan att anropa webhooken.
  4. Koppla Incoming Webhook Trigger och Manual Launch Trigger till Route by Query.

Använd Manual Launch Trigger för snabb testning; använd Incoming Webhook Trigger för den live-dashboard ni kör i drift.

Steg 2: Anslut n8n-API:et

Arbetsflödet läser sin egen lista över arbetsflöden och data för enskilda arbetsflöden via n8n-API:et.

  1. Öppna Retrieve Workflow List och lägg till autentiseringsuppgifter.
  2. Credential Required: Anslut era n8nApi-autentiseringsuppgifter.
  3. Öppna Fetch Single Workflow och bekräfta att den använder samma typ av autentisering.
  4. Credential Required: Anslut era n8nApi-autentiseringsuppgifter.

⚠️ Vanlig fallgrop: Saknade n8nApi-autentiseringsuppgifter gör att både list- och diagram-endpoints misslyckas.

Steg 3: Konfigurera query-routern

Switchen routar anrop baserat på om en wfid-queryparameter finns.

  1. Öppna Route by Query och bekräfta två utgångar: load page och has wfid.
  2. För load page, ställ in villkoret till ArrayEmpty med Left Value {{ Object.keys($json?.query)}}.
  3. För has wfid, ställ in villkoret till StringContains med Left Value {{ Object.keys($json.query).join(',') }} och Right Value wfid.
  4. Koppla utgången load page till Retrieve Workflow List och utgången has wfid till Fetch Single Workflow.

Steg 4: Bygg arbetsflödeslistan för dashboarden

Den här vägen samlar in metadata för arbetsflöden och förbereder det för HTML-svaret till dashboarden.

  1. I Retrieve Workflow List, lämna Filters tomt för att hämta alla arbetsflöden.
  2. I Map Workflow Items, ställ in tilldelningen så att den skapar wf_data med värdet { "id":"{{ $json.id }}", "name":"{{ $json.name }}" }.
  3. I Consolidate Records, aggregera fältet wf_data för att slå ihop poster till en lista.
  4. I Set Runtime Config, behåll Include Other Fields aktiverat och ställ in:
  5. instance_url till {{$env["N8N_PROTOCOL"]}}://{{$env["N8N_HOST"]}}, webhook_name till {{ $('Incoming Webhook Trigger').params.path}}, och webhook_path till {{$env["N8N_ENDPOINT_WEBHOOK"] || "webhook"}}.

Noden Set Runtime Config bygger URL:er dynamiskt med hjälp av miljövariabler och sökvägen i Incoming Webhook Trigger.

Steg 5: Generera Mermaid-diagram

Den här vägen hämtar ett enskilt arbetsflöde och konverterar dess kopplingar till Mermaid-syntax.

  1. I Fetch Single Workflow, ställ in Operation till get och Workflow ID till {{ $json.query.wfid }}.
  2. Öppna Transform Mermaid Chart och behåll den tillhandahållna JavaScript Code som bygger mermaidChart från arbetsflödets noder och kopplingar.
  3. Bekräfta att Transform Mermaid Chart är kopplad till Return Mermaid Output.

Steg 6: Konfigurera utdata-svar

Arbetsflödet svarar antingen med dashboardens HTML eller Mermaid-diagramkoden.

  1. I Deliver Dashboard Page, ställ in Respond With till text och behåll hela HTML:en i Response Body enligt det som tillhandahålls.
  2. I Return Mermaid Output, ställ in Respond With till text och Response Body till {{ $json.mermaidChart }}.
  3. Säkerställ att Set Runtime Config är kopplad till Deliver Dashboard Page och att Transform Mermaid Chart är kopplad till Return Mermaid Output.

⚠️ Vanlig fallgrop: Om Response ModeIncoming Webhook Trigger inte är satt till Respond to Webhook, kommer svarsnoderna inte att skicka någon utdata.

Steg 7: Testa och aktivera ert arbetsflöde

Kör arbetsflödet för att validera både dashboarden och Mermaid-diagram-endpoints.

  1. Klicka på Execute Workflow för att köra Manual Launch Trigger och bekräfta att Route by Query routar korrekt.
  2. Anropa webhooken utan en wfid-queryparameter och verifiera att Deliver Dashboard Page returnerar HTML-sidan.
  3. Anropa webhooken med ?wfid=YOUR_WORKFLOW_ID och verifiera att Return Mermaid Output returnerar Mermaid-kod.
  4. När testerna lyckas, slå på arbetsflödet till Active för användning i produktion.
🔒

Lås upp fullständig steg-för-steg-guide

Få den kompletta implementeringsguiden + nedladdningsbar mall

Felsökningstips

  • GitHub-credentials kan gå ut eller kräva specifika behörigheter. Om något slutar fungera, kontrollera först dina token-scopes och credential-testet inne i n8n.
  • Om du använder Wait-noder eller extern rendering varierar bearbetningstiderna. Öka väntetiden om nedströms noder fallerar på tomma svar.
  • Standardprompter i AI-noder är generiska. Lägg in er tonalitet tidigt, annars kommer du att redigera utdata i all evighet.

Snabba svar

Hur lång tid tar det att sätta upp den här automationen för delning av Mermaid-diagram?

Cirka 30 minuter om dina n8n-credentials är klara.

Krävs kodning för den här delningen av Mermaid-diagram?

Nej. Du kommer främst att konfigurera credentials och uppdatera ett par runtime-fält.

Är n8n gratis att använda för det här workflowet för delning av Mermaid-diagram?

Ja. n8n har ett gratis self-hosted-alternativ och en gratis provperiod på n8n Cloud. Cloud-planer börjar på 20 USD/månad för högre volymer. Du behöver också räkna in GitHub-kostnader (vanligtvis 0 USD) om du använder det för backuper.

Var kan jag hosta n8n för att köra den här automationen?

Två alternativ: n8n Cloud (hanterat, enklast att komma igång) eller self-hosting på en VPS. För self-hosting är Hostinger VPS prisvärd och hanterar n8n bra. Self-hosting ger obegränsade körningar men kräver grundläggande serveradministration.

Kan jag anpassa det här workflowet för delning av Mermaid-diagram för andra användningsfall?

Ja, och det uppmuntras. De flesta team anpassar värdena i ”Set Runtime Config” (som din instans-URL) och justerar kodsteget ”Transform Mermaid Chart” för att ändra former, etiketter eller hur inaktiverade noder visas. Du kan också tweaka logiken i ”Route by Query” för att lägga till nya vyer, som ”visa bara aktiva workflows” eller ”filtrera på tagg”.

Varför misslyckas min GitHub-anslutning i det här workflowet?

Oftast är det token. Skapa en ny GitHub-token, bekräfta att den har rätt repo-åtkomst och uppdatera sedan credentialen i n8n. Om repot är privat kommer saknade scopes att se ut som ”not found”-fel, vilket är förvirrande. Kontrollera också rate limits om du laddar många diagram under en kort tidsperiod.

Vilken volym kan det här workflowet för delning av Mermaid-diagram hantera?

En typisk setup hanterar dussintals diagramförfrågningar per timme utan problem. På n8n Cloud beror volymen på dina exekveringsgränser; om du self-hostar handlar det mest om serverstorlek och hur tung din workflow-JSON är. För de flesta team är rendering av ett enskilt workflow-diagram tillräckligt snabb för att kännas omedelbar.

Är den här automationen för delning av Mermaid-diagram bättre än att använda Zapier eller Make?

I de flesta fall, ja. Zapier och Make är inte byggda för att servera en anpassad webbsida med diagram från ett webhook-svar, och de blir klumpiga när du behöver routinglogik (listvy vs enskilt workflow) i en endpoint. n8n gör också mönstret ”hämta från API, transformera, svara” rakt på sak eftersom du kan forma data och returnera HTML direkt. Den större poängen är kontroll: du kan self-hosta, hålla allt internt och anpassa utdata. Prata med en automationsexpert om du vill ha hjälp att avgöra vad som är värt att bygga jämfört med att köpa.

När det här är live blir ”Kan du förklara det här workflowet?” till en länk. Bara det är ärligt talat värt det.

Kontakta oss

Hör av dig, så diskuterar vi hur just din verksamhet kan dra nytta av alla fantastiska möjligheter som AI skapar.

×

Använd mall

Få direkt tillgång till denna n8n-arbetsflödes JSON-fil

Launch login modal Launch register modal