Markdy

•
107
•

Generates open-source animated architecture diagrams as code using a diagram-native DSL, powered by the Web Animations API and an MCP server for AI agents.

Markdy is an open-source diagram-as-code DSL designed for creating animated architecture and system design explainers. It transforms declarative MarkdyScript into choreographed, 60fps browser-native kinetic diagrams using the Web Animations API. Unlike static diagrams, Markdy brings complex distributed systems to life with kinetic storytelling, camera zooms, and glowing cues. It offers zero-config routing, supports 17 specialized layout engines and 8 themes, and provides universal ingestion to convert existing diagrams from Mermaid, Draw.io, Docker Compose, Kubernetes, and Terraform into animated scenes. Built with AI agents in mind, Markdy includes an official Model Context Protocol (MCP) server for LLMs, enabling self-healing syntax diagnostics and architecture governance through built-in CI/CD rules.

主要功能

01Architecture Governance with built-in CI/CD rules to prevent deadlock cycles and generate visual AST diffs.
02Zero-Config Routing with collision-aware orthogonal Manhattan edge routing and auto-layout.
03Universal Ingestion for 1-command import from Mermaid, Draw.io, Docker Compose, K8s, and Terraform.
0484 GitHub stars
05Kinetic Storytelling with animated requests, responses, and events across timelines.
06AI-Native and MCP Server integration for LLMs with self-healing syntax diagnostics.

使用案例

01Visualizing and explaining complex animated architecture and system designs.
02Automating diagram generation from existing infrastructure code like Docker Compose, Kubernetes, and Terraform.
03Integrating with AI agents and LLMs for diagram generation, validation, and explanation.