drawio-syntax-connections

Configure edge routing, connections, and labels in Draw.io mxGraph XML.

4|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Draw.io-Claude-Skill-Package --skill drawio-syntax-connections
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drawio-syntax-connections
Source: https://github.com/OpenAEC-Foundation/Draw.io-Claude-Skill-Package/tree/main/skills/source/drawio-syntax/drawio-syntax-connections
Command: npx skills add https://github.com/OpenAEC-Foundation/Draw.io-Claude-Skill-Package --skill drawio-syntax-connections

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guide teaches how to connect shapes with edges in Draw.io diagrams, preventing the common mistakes of hardcoding waypoints and misplacing exit/entry points. It clarifies when to use floating versus fixed connections, edge routing styles, and edge labels so diagrams stay robust as they evolve.

Core Features & Use Cases

  • Floating vs fixed connections with auto-routing to keep edges attached to shapes as they move.
  • Support for various edge styles (orthogonal, elbow, isometric, self-loops) and fixed connection points.
  • Custom connection points and edge labels positioning to convey meaning without clutter.
  • Real-world scenarios include flowcharts, architectural diagrams, ER models, and UML-style diagrams where reliable routing matters.

Quick Start

Create a basic edge between two shapes and rely on the router to compute an optimal path.

Frequently Asked Questions about drawio-syntax-connections

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Draw.io edges attached to shapes when moving them?

Floating connections keep Draw.io edges attached to shapes automatically, using auto-routing to compute optimal paths as elements move. Fixed connections anchor edges to specific points, preventing unwanted shifts during layout changes.

What edge styles are available for routing in mxGraph XML?

mxGraph XML supports orthogonal, elbow, isometric, and self-loop edge styles. These edgeStyle options control how Draw.io routes connections between shapes, enabling precise diagram layouts for flowcharts and architectural diagrams.

When should I use fixed versus floating connection points in Draw.io?

Use floating connections when shapes move frequently and need auto-routing. Use fixed connection points when edges must attach to specific perimeter locations, ensuring stable routing in UML-style diagrams or ER models.

Why does my Draw.io edge routing break after adding waypoints?

Hardcoding waypoints in Draw.io causes edge routing to break when shapes move. Rely on the router to compute paths automatically, using floating connections and edgeStyle options instead of manually specifying fixed waypoint coordinates.

Can I create self-loops and custom edge labels in Draw.io?

Draw.io supports self-loops and custom edge label positioning within mxGraph XML. Label positioning rules allow you to convey meaning without clutter, applying to flowcharts, ER models, and architectural diagrams.

Does this Draw.io edge routing approach work for ER models and UML diagrams?

This approach suits ER models, UML-style diagrams, flowcharts, and architectural diagrams requiring reliable edge routing. It covers fixed and floating connections, perimeters, and edge label positioning within mxGraph XML.