Export diagrams as SVG images

diagrams.net 07 Oct 2018


SVG images load quickly, especially when compared to loading diagram images in other formats. You can embed an SVG image exported from diagrams.net in a website, document or even a WordPress site if you have installed a plugin that support the upload of SVG files.

SVG or Scalable Vector Graphics is a file format that defines vector-graphics using the XML markup language, similar to the .drawio file format used for diagrams created in diagrams.net. SVG images can be enlarged or shrunk without losing quality or introducing pixellation, unlike .JPG, .GIF and .PNG image formats. Because SVG uses XML code, non-image code can be embedded in these files, which has resulted in them not being supported on certain platforms (like WordPress) without third-party plugins.

You must disable text formatting and word wrap on all labels in your diagram before you export it to the SVG image. This makes sure that the text in your diagram will display correctly.

Prepare your diagram for export

  1. Right-click on an empty spot of the drawing canvas, and click on Select All in the context menu to select everything in your diagram (or press Ctrl+A on Windows, Cmd+A on MacOS).
  2. In the Text tab of the format panel on the right, make sure the Formatted Text checkbox is deselected.
  3. Next, select all of the vertices in your diagram - right-click and choose Select Vertices (or press Ctrl+Shift+I on Windows, Cmd+Shift+I on MacOS).
  4. Again in the Text tab of the format panel, make sure that the Word Wrap checkbox is deselected.

Prepare your diagram for exporting to SVG in diagrams.net by disabling word wrap and text formatting

Export your diagram to SVG

Your diagram is now ready to be exported to an SVG image.

  1. Click File > Export as > SVG.
  2. A dialog with a number of options lets you customise how your diagram will be saved to an SVG image:
    • Change the Zoom percentage.
    • Use a Transparent Background instead of the default white background.
    • If you have selected part of your diagram before exporting it as an SVG, you’ll be able to limit what is saved in the diagram as your Selection Only, and Crop the image to fit your selection.
    • Add a Shadow to your diagram.
    • Leave Include a copy of my diagram enabled if you want others to be able to import the SVG back into diagrams.net smoothly.
    • Choose how Links behave by altering the setting in the list. diagrams.net options when exporting a diagram as an SVG image
  3. When you have set the options you want, click Export and choose the location to which you want to save the SVG file.

Now you can add the SVG image version of your diagram to your webpage or blog post as you would a normal image file.

Follow us on GitHub, Twitter, Facebook, YouTube.