drawio

Embed editable draw.io diagrams inline in Markdown using viewer.js.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/shekerkamma/markdown-viewer-skills-audit --skill drawio-shekerkamma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drawio
Source: https://github.com/shekerkamma/markdown-viewer-skills-audit/tree/main/drawio
Command: npx skills add https://github.com/shekerkamma/markdown-viewer-skills-audit --skill drawio-shekerkamma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables embedding editable draw.io / diagrams.net diagrams directly inside Markdown pages, allowing diagrams to render inline without leaving the document.

Core Features & Use Cases

  • Interactive diagrams rendered in Markdown using the official viewer.js library, with full editing capabilities in diagrams.net when opened.
  • Supports network topologies, software architectures, BPMN flows, and other diagram types from the extensive shape library.
  • Use Case: In product documentation, embed an architecture diagram that readers can open and edit in-app.

Quick Start

Drop a div with class mxgraph containing the diagram payload and include the viewer script once per page to render diagrams.

Frequently Asked Questions about drawio

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

FAQPage Schema
How do I embed draw.io diagrams inline in Markdown?

To embed draw.io diagrams inline in Markdown, load the official viewer.js once per page and wrap each diagram's XML payload in a div with class mxgraph. This renders interactive architecture and network topology visuals directly in the document.

Can I edit diagrams.net files directly inside Markdown documentation?

Yes, you can edit diagrams.net files directly inside Markdown documentation. Diagrams rendered via the viewer.js library retain full editing capabilities, allowing readers to open and modify architecture or BPMN flows in-app without leaving the page.

What types of technical diagrams can I render using viewer.js in Markdown?

You can render various technical diagrams using viewer.js in Markdown, including software architecture diagrams, network topologies, and BPMN flows. It leverages the extensive mxgraph shape library to display complex visuals inline.

How do I display interactive network topology diagrams in technical docs?

Display interactive network topology diagrams in technical docs by including the official viewer.js script and wrapping the diagram XML payload in a div with class mxgraph. This allows diagrams to render inline without leaving the document.

Do I need to load viewer.js separately for each diagram in Markdown?

No, you do not need to load viewer.js separately for each diagram in Markdown. The official viewer.js library only needs to be loaded once per page to render all subsequent mxgraph div elements containing diagram XML payloads.

Why are my embedded mxgraph diagrams not rendering in Markdown?

Embedded mxgraph diagrams might not render in Markdown if the official viewer.js script is missing from the page or if the diagram XML payload is not properly wrapped in a div with class mxgraph. Ensure both prerequisites are correctly implemented.