Guide · Mermaid in Microsoft Word
How to Insert Mermaid Diagrams in Word
Microsoft Word has no built-in Mermaid support, so pasting diagram code into a document just shows text. The reliable workflow is to render the Mermaid code in your browser, export it as a PNG or SVG image, and insert that image into Word. The whole round trip takes under a minute and produces print-ready output.
No signup · No watermark · Local browser rendering · Print-ready 2x and 4x output
Does Word render Mermaid natively?
No version of Microsoft Word renders Mermaid syntax, and there is no first-party plugin that does. Converting the diagram to an image is the standard approach. Word 2016 and Microsoft 365 also accept SVG images, which scale perfectly for print; older Word versions should use a high-resolution PNG instead.
Insert a Mermaid diagram into a Word document
- 1
Paste your Mermaid code
Drop your diagram code into the converter below. It renders locally in your browser — nothing is uploaded, which matters for internal specs and client documents.
- 2
Choose a document-friendly style
Clean Docs on a white background looks native inside reports and specs. Keep the background white so the diagram blends into the page like any other figure.
- 3
Export PNG at 2x — or SVG for Microsoft 365
A 2x PNG stays sharp in print and PDF exports of your document. On Word 2016 or Microsoft 365, SVG is even better: it is vector, so it never pixelates at any print size.
- 4
Insert the image in Word
Use Insert → Pictures → This Device and select the exported file, or drag it straight into the document. Use Word's layout options to wrap text or center the figure.
Export your diagram here
Paste your Mermaid code below, pick a style, and download the image. Everything renders locally in your browser — no signup, no watermark.
Export controls activate after your diagram renders locally.
Which format works best in Word?
Works in every Word version and email round trip. Export at 2x so labels stay sharp when the document is printed or saved as PDF.
Word 2016 and Microsoft 365 insert SVG natively. Vector output scales to any size without pixelation, ideal for A4 reports and posters.
JPG compression softens thin lines and small text. Only use it when a legacy workflow strictly requires JPG attachments.
FAQ
Questions about this workflow
Can Microsoft Word render Mermaid code directly?+
No. Word has no Mermaid engine in any version, including Microsoft 365. Convert the diagram to a PNG or SVG image and insert it like any other figure.
PNG or SVG — which should I insert into Word?+
Use SVG if you are on Word 2016 or Microsoft 365 and the document will be printed: vector images never pixelate. Use a 2x PNG for maximum compatibility with older versions and email workflows.
Why does my diagram look blurry when I print the document?+
It was probably exported at 1x screen resolution. Re-export at 2x or 4x scale, or switch to SVG. Higher pixel density is what keeps labels crisp on paper and in PDF exports.
Is my diagram uploaded anywhere during conversion?+
No. This converter renders Mermaid locally in your browser, so diagram code for confidential specs and internal documents never leaves your machine.