drawio-impl-mermaid-conversion

Mermaid conversion in Draw.io can produce a single compound shape, making individual mxCells non-editable. This happens because the conversion process groups the entire diagram rather than mapping individual elements to separate editable mxCells.

Use Mermaid for rapid prototyping and supported diagram types, but switch to native Draw.io XML (mxGraph) for production diagrams requiring individual element editing. A decision framework evaluates editability needs to determine the correct approach.

Pass Mermaid content directly to the open_drawio_mermaid MCP tool to render the diagram. Validate syntax beforehand and follow safe workflow requirements to ensure the output meets production standards before deciding on final format.

The conversion supports a specific range of Mermaid diagram types. Supported types and their conversion methods are documented to clarify which diagrams can be rendered, along with known limitations for each type during the conversion process.

Key limitations include loss of individual mxCell editability after conversion, producing compound shapes instead. The documentation outlines these constraints to prevent incorrect assumptions about post-conversion editing capabilities in production environments.

No, Mermaid conversion typically creates a single compound shape where individual mxCells are non-editable. For editable individual elements, use native Draw.io XML (mxGraph) instead of Mermaid conversion for the final production diagram.