draw-io-diagram-generator

Generate an mxfile XML document containing a diagram element with an mxGraphModel and root cells id 0 and 1, then add vertex cells with mxGeometry and edge cells with source and target references. The file opens directly in the VS Code draw.io extension or the draw.io web app.

Run the validate-drawio.py script with Python 3.8 or later, passing the file path. It checks root cells, unique IDs, edge connectivity, parent chains, geometry elements, and XML well-formedness, exiting with code 0 on success.

The mxGraph format supports flowcharts, system architecture with swimlane layers, sequence diagrams with lifelines, ER diagrams with crow's-foot notation, UML class diagrams, network topologies, BPMN workflows, and Kubernetes resource diagrams.

A blank render usually means the mandatory root cells id="0" and id="1" are missing or not the first two cells in the root element. Add both cells before any content cells and ensure every other cell has a valid parent reference.

Yes. Read the file first to learn existing IDs and parent hierarchy, assign new unique IDs, and respect container-relative coordinates for swimlane children. The add-shape.py script inserts a single shape safely without hand-editing raw XML.