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
flowchart LR
subgraph sg0["When clicking ‘Test workflow’ Flow"]
direction LR
n0@{ icon: "mdi:play-circle", form: "rounded", label: "When clicking ‘Test workflow’", pos: "b", h: 48 }
n1["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/webhook.dark.svg' width='40' height='40' /></div><br/>Respond with Mermaid"]
n2["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/n8n.svg' width='40' height='40' /></div><br/>List workflows"]
n3@{ icon: "mdi:cog", form: "rounded", label: "Aggregate", pos: "b", h: 48 }
n4["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/n8n.svg' width='40' height='40' /></div><br/>Single workflow"]
n5@{ icon: "mdi:swap-horizontal", form: "rounded", label: "Switch", pos: "b", h: 48 }
n6["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/webhook.dark.svg' width='40' height='40' /></div><br/>Send Page"]
n7@{ icon: "mdi:swap-vertical", form: "rounded", label: "Prepare workflow list", pos: "b", h: 48 }
n8@{ icon: "mdi:swap-vertical", form: "rounded", label: "CONFIG", pos: "b", h: 48 }
n9["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/code.svg' width='40' height='40' /></div><br/>Code"]
n10["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/webhook.dark.svg' width='40' height='40' /></div><br/>Webhook"]
n9 --> n1
n8 --> n6
n5 --> n2
n5 --> n4
n10 --> n5
n3 --> n8
n2 --> n7
n4 --> n9
n7 --> n3
n0 --> n5
end
%% Styling
classDef trigger fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
classDef ai fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
classDef aiModel fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px
classDef decision fill:#fff8e1,stroke:#f9a825,stroke-width:2px
classDef database fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef api fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef code fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef disabled stroke-dasharray: 5 5,opacity: 0.5
class n0 trigger
class n5 decision
class n1,n6,n10 api
class n9 code
classDef customIcon fill:none,stroke:none
class n1,n2,n4,n6,n9,n10 customIcon
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
| Vad som automatiseras | Vad du uppnår |
|---|---|
|
|
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.
- Lägg till Incoming Webhook Trigger och ställ in Path till
dd9e2c5d-6c48-428e-aa54-bef9e369d3b0. - Ställ in Response Mode till Respond to Webhook för att skjuta upp svaret till Deliver Dashboard Page eller Return Mermaid Output.
- Lägg till Manual Launch Trigger så att ni kan testa routning från editorn utan att anropa webhooken.
- Koppla Incoming Webhook Trigger och Manual Launch Trigger till Route by Query.
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.
- Öppna Retrieve Workflow List och lägg till autentiseringsuppgifter.
- Credential Required: Anslut era n8nApi-autentiseringsuppgifter.
- Öppna Fetch Single Workflow och bekräfta att den använder samma typ av autentisering.
- Credential Required: Anslut era n8nApi-autentiseringsuppgifter.
Steg 3: Konfigurera query-routern
Switchen routar anrop baserat på om en wfid-queryparameter finns.
- Öppna Route by Query och bekräfta två utgångar: load page och has wfid.
- För load page, ställ in villkoret till Array → Empty med Left Value
{{ Object.keys($json?.query)}}. - För has wfid, ställ in villkoret till String → Contains med Left Value
{{ Object.keys($json.query).join(',') }}och Right Valuewfid. - 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.
- I Retrieve Workflow List, lämna Filters tomt för att hämta alla arbetsflöden.
- I Map Workflow Items, ställ in tilldelningen så att den skapar wf_data med värdet
{ "id":"{{ $json.id }}", "name":"{{ $json.name }}" }. - I Consolidate Records, aggregera fältet wf_data för att slå ihop poster till en lista.
- I Set Runtime Config, behåll Include Other Fields aktiverat och ställ in:
- 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"}}.
Steg 5: Generera Mermaid-diagram
Den här vägen hämtar ett enskilt arbetsflöde och konverterar dess kopplingar till Mermaid-syntax.
- I Fetch Single Workflow, ställ in Operation till
getoch Workflow ID till{{ $json.query.wfid }}. - Öppna Transform Mermaid Chart och behåll den tillhandahållna JavaScript Code som bygger
mermaidChartfrån arbetsflödets noder och kopplingar. - 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.
- I Deliver Dashboard Page, ställ in Respond With till
textoch behåll hela HTML:en i Response Body enligt det som tillhandahålls. - I Return Mermaid Output, ställ in Respond With till
textoch Response Body till{{ $json.mermaidChart }}. - Säkerställ att Set Runtime Config är kopplad till Deliver Dashboard Page och att Transform Mermaid Chart är kopplad till Return Mermaid Output.
Steg 7: Testa och aktivera ert arbetsflöde
Kör arbetsflödet för att validera både dashboarden och Mermaid-diagram-endpoints.
- Klicka på Execute Workflow för att köra Manual Launch Trigger och bekräfta att Route by Query routar korrekt.
- Anropa webhooken utan en
wfid-queryparameter och verifiera att Deliver Dashboard Page returnerar HTML-sidan. - Anropa webhooken med
?wfid=YOUR_WORKFLOW_IDoch verifiera att Return Mermaid Output returnerar Mermaid-kod. - När testerna lyckas, slå på arbetsflödet till Active för användning i produktion.
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
Cirka 30 minuter om dina n8n-credentials är klara.
Nej. Du kommer främst att konfigurera credentials och uppdatera ett par runtime-fält.
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.
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.
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”.
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.
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.
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.