drawio-to-html

Drawio to HTML

Convert drawio/diagrams.net XML files into standalone HTML pages with embedded SVG.

Supported Input

• .drawio files (diagrams.net / draw.io native format)
• Files containing mxGraphModel XML structure

Supported Output

• Self-contained .html files with embedded SVG
• No external dependencies — open directly in any browser
• Preserves original colors, shapes, rounded corners, diamonds, arrows, edge labels

Workflow

Step 1: Locate the drawio file

Get the file path from the user or workspace context.

Step 2: Run the conversion script

Execute the bundled Python script:

python3 scripts/drawio2html.py  [output.html]

If output.html is omitted, the script defaults to .html in the same directory.

Step 3: Report results

Tell the user:

• Output file path
• File size
• Diagram name extracted from the XML
• Any nodes/edges that could not be rendered (if applicable)

Node Shape Support

Edge Support

• Orthogonal connectors with waypoints
• Solid and dashed lines
• Arrow markers
• Edge labels ("是"/"否" branch annotations)

Limitations

• Does not render: swimlanes, images, complex gradient fills, custom shapes
• Text inside nodes is centered; multi-line text supported
• Only the first `` element is rendered if multiple exist

Script Reference

The conversion logic lives in scripts/drawio2html.py. It is a pure-Python script with no external dependencies beyond the standard library (xml.etree, re, sys, os).