2 minutes to read
About This Task
There is no
exportDrawIo task available in docToolchain because such a task is not required.
You can continue to use diagrams.net (formerly known as draw.io) to edit your diagrams simply by making a change to your diagram-authoring workflow.
diagrams.net offers free and open source desktop editors for all major operating system platforms.
Visit https://www.diagrams.net/integrations to find a desktop editor application compatible with your operating system.
When you use the desktop version, just create your diagram with the
.png (or even better,
.dio.png) extension and diagrams.net will always save your diagram as a PNG with the source as metadata.
They have also launched a free plugin for VS Code and IntelliJ, so you can edit your diagrams offline!
How to Change Your Workflow to Use diagrams.net
Export your diagrams.net/draw.io diagrams as a PNG with the source embedded in the file metadata.
This allows you to embed your diagrams into AsciiDoc source as you normally would (using the
image:: macro) with the added advantage of storing the diagram source with the image itself.
How to Convert a Confluence Page to AsciiDoc
If you are converting a Confluence page with embedded draw.io diagrams to AsciiDoc, use this export workflow to continue using diagrams.net:
Export an editable PNG diagram from Confluence.
Load the diagram you want to export from Confluence.
In the Image modal, make sure that Include a copy of my diagram is selected.
Click Export to save the PNG file with the pattern
Commit the exported PNG file to source control.
Your diagram can now be managed in source control, added to your documentation source and edited using a diagrams.net desktop version.
.dio (short for "drawio") in the name will help you identify PNG files containing an embedded XML diagram source.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.