Markdy: Mermaidダイアグラムのように、しかし動きのために
Markdy: Like Mermaid Diagrams, but for Motion (markdy.com)
要約
Markdyは、Mermaidダイアグラムのようにテキストベースでアニメーションを記述するためのツールです。シンプルな構文でシーン設定、アクターの配置、タイムライン上の動き、スピーチ、エフェクトなどを定義できます。これにより、複雑なアニメーションをコードのように記述し、共同作業やバージョン管理を容易にすることが目的です。
全文翻訳
プレーンテキストからアニメーション化されたアーキテクチャ図を生成
レイアウトとプレゼンテーション
17のドメインネイティブエンジンと8つの公開テーマ
マイクロサービス、セキュリティ境界、メダリオンパイプライン、スプリントロードマップまで。
アーキテクチャとシステム
type=architecture
スマートな障害物回避エッジルーティング(デフォルト)を備えたランク付けされたDAGトポロジー。
type=flowchart
トップダウンの意思決定分岐、条件付きルーティング、パイプラインステップ。
type=tree
共有水平兄弟バスを持つ親子階層。
type=state
サイクルセーフなステートマシン遷移、ループ、自己参照アーク。
type=sequence
参加者列、ライフライン、順序付けられたメッセージ、アクティベーション範囲。
構造とセキュリティ境界
type=layers
全幅水平スタック抽象化バンド(OSI、CSSカスケード、メモリ)。
type=nested
防御深度のためのステップインセットを備えた同心円状の丸い境界。
type=swimlane
部門横断的なチームレーンとマルチアクターハンドオフトラック。
パイプライン、ロードマップ、ラジアル
type=timeline
交互のマイルストーン配置を備えた水平ヘアラインベースライン。
type=gantt
フェーズとスパンプロパティを持つ、フェーズベースの水平バースタッキング。
type=medallion
マルチティアのブロンズ → シルバー → ゴールドのレイクハウスデータステージ。
type=flywheel
接線フローパスを持つ円形のクローズドループ複合エンジン。
type=constellation
決定論的な軌道装飾を備えたラジアルフォーカルノードレイアウト。
キュレーションされた公開テーマ
theme=paper
高コントラストシリーズパレットを備えたクリーンなライトドキュメントキャンバス。
theme=editorial
セリフ体タイポグラフィ、洗練されたインクライン、控えめなセマンティックアクセント。
theme=terminal
鮮やかな蛍光グローアクセントを備えたモノスペースCLI美学。
theme=sketchy
SVG変位タービュランスを備えたオーガニックな手描きのホワイトボードスタイル。
theme=ink
ボールペン、万年筆、シアノタイプ、磁器プリントにインスパイアされたモノクロームのブルー。
theme=doodle
フェルトペンとコミックブロックの影を備えた、遊び心のある手描きのスケッチブック。
theme=blueprint
シアンワイヤーフレームジオメトリを備えたテクニカルCAD製図グリッド。
theme=midnight
レイヤードガラスモーフィズムの高度を備えたディープ開発者キャンバス。
ユニバーサル取り込み
最初から始める必要はありません
既存の静的なアーキテクチャ定義を、1つのコマンドまたは1クリックでアニメーション化されたMarkdyScriptシーンに変換します。
$markdy import flow.mmd --out flow.markdy
flowchart LR
Client[Client Browser] --> Gateway[API Gateway]
Gateway --> Auth[Auth Service]
Auth --> DB[(PostgreSQL)]
Auth -.-> Cache[(Redis Session)]
scene theme=paper type=flowchart
layout TB
service Client "Client Browser"
gateway Gateway "API Gateway"
service Auth "Auth Microservice"
cache Cache "Redis Session"
database DB "PostgreSQL"
beat flow:
show $nodes stagger=60ms
Client -> Gateway "POST /login"
Gateway -> Auth "Validate"
Auth -> DB "Query Credentials"
Auth -> Cache "Set Session"
Gateway <- Auth "JWT Token"
player:
playback:
loop true
controls:
speed true
speeds "0.25"
fullscreen true
gif true
theme true
interaction:
zoom true
pan true
click_to_play true
double_click_to_reset true
keyboard false
chrome:
badge true
progress none
color "#3b82f6"
コアバリュー
エンジニアとチームがMarkdyを選ぶ理由
最新のソフトウェアアーキテクチャ、自律コーディングエージェント、CI/CDレビューのために構築されたダイアグラムレイヤー。
セマンティックノード、グループ、フロー、タイムドビートをレビュー可能なテキストで宣言します。レイアウト、衝突回避、振り付けは100%自動です。
詳細はこちら ↗
Mermaidフローチャート、Draw.io XML、Docker Compose、Kubernetes YAML、Terraform状態からアニメーションシーンへの1クリック転写。
詳細はこちら ↗
Claude、Cursor、Antigravity向けの公式モデルコンテキストプロトコルサーバー。自己修復構文診断とプロンプトテンプレートを備えています。
詳細はこちら ↗
自動CI/CDリンターがデッドロックサイクル、クロスレイヤーバイパス、グラウンディングされていないサービスを検出し、セマンティックPR差分を出力します。
詳細はこちら ↗
機能マトリックス
完全なシステムサポートと統合マトリックス
サポートされている取り込みフォーマット、エクスポートターゲット、分析機能、フレームワーク統合の透明な概要。
取り込みと転写入力
| ソースフォーマット | ステータス | サポートされている機能 | ドキュメントとデモ |
|---|---|---|---|
Mermaidフローチャート (.mmd, ```mermaid) | 安定 | ノード、サブグラフ、方向(LR/TB)、フローラベル、シェイプ | 移行ガイド ↗ |
Docker Compose (docker-compose.yml) | 安定 | サービス、コンテナポート、ボリュームストレージ、ネットワーク | スタジオでのインポート ↗ |
Kubernetesマニフェスト (k8s.yaml) | 安定 | デプロイメント、ポッド、サービス、イングレス、永続ボリューム | K8sガイド ↗ |
Terraform状態/HCL (.tf, .tfstate) | 安定 | AWS / GCP / Azureリソース、VPC、サブネット、DAG依存関係 | スタジオでのインポート ↗ |
Draw.io XML (.drawio, .xml) | ベータ | mxGraph頂点ジオメトリ、ラベル、グループ化されたコンテナ | Draw.ioインポートを試す ↗ |
エクスポートターゲットと開発者フレームワーク
| ターゲット/プラットフォーム | ステータス | パッケージ/ツール | 機能 |
|---|---|---|---|
| ブラウザWebアニメーション(WAAPI) | 安定 | @markdy/renderer-dom | ハードウェアアクセラレーション60fpsモーション、カメラフレーミング、パルスキュー |
| スタンドアロンHTMLバンドル | 安定 | markdy render <file> | 埋め込みダーク/ライトテーマを備えたゼロ依存のオフラインHTMLファイル |
| ベクターSVG&PNGラスター | 安定 | スタジオ/CLI | 埋め込みスタイルを備えた鮮明な無限解像度SVGベクター |
| Astro統合 | 安定 | @markdy/astro | クライアントハイドレーションを備えたSSRフレンドリーな<Markdy />コンポーネント |
| MDX / Next.js / Docusaurus | 安定 | @markdy/mdx | インデント折りたたみ耐性を備えた<MarkdyDiagram />コンポーネント |
| AI MCPサーバー&診断 | 安定 | @markdy/mcp-server | 自己修復機能付きのCursor、Claude、Antigravity用ネイティブツール |
| CI/CDガバナンス&マルチファイルチェック | 安定 | markdy check / markdy lint | デッドロックサイクル防止、クロスレイヤーリンター、--dist HTMLバリデーター |
AIネイティブアーキテクチャ
公式モデルコンテキストプロトコル(MCP)サーバー
Claude Desktop、Cursor、またはAntigravityをMarkdyにポイントして、インスタントAST検証と自己修復ダイアグラムを取得します。
AIとMarkdyの連携方法
-
ホストされたエージェント参照
markdy.com/AGENT.mdまたはllms.txtをコーディングアシスタントと共有します。 -
自然言語でのプロンプト
「RedisとPostgresを使ったキャッシュアサイドアーキテクチャ図を描いてください。」
-
自律的な自己修復ループ
MCPサーバーはASTを自動的に解析し、無効なキューやノードのタイプミスを修正します。
{
"mcpServers": {
"markdy": {
"command": "npx",
"args": ["-y", "@markdy/mcp-server"]
}
}
}
クイックスタートと統合
任意のフレームワークでのドキュメントとしてのコード
import { createDiagram } from "@markdy/renderer-dom";
const diagram = createDiagram({
container: document.getElementById("scene"),
code: `
scene theme=paper
client WebApp -> service Api -> database Postgres
`,
});
diagram.play();
---
import { Markdy } from "@markdy/astro";
const sceneCode = `
scene theme=paper
client WebApp -> service Api -> database Postgres
`;
---
<Markdy code={sceneCode} autoplay />
// MDXドキュメントファイル内:
```markdy
scene theme=paper
client Browser -> gateway API -> cache Redis
```
# CLIをグローバルにインストール
npm install -g @markdy/cli
# シーンをインタラクティブなHTMLにレンダリング
markdy render system.markdy --open
# CI/CDで全てのダイアグラムをバッチ検証
markdy check-all ./docs/diagrams
よくある質問
FAQ
Markdyは、アニメーション化されたアーキテクチャとシステムダイアグラムのためのオープンソースのダイアグラムネイティブDSLです。セマンティックノード、グループ、フロー、ビートをプレーンテキストで記述します。Markdyは、座標計算や手動キーフレームなしで、ブラウザネイティブのモーショングラフィックスをコンパイルします。
Mermaid、D2、PlantUMLは静的な2D画像を生成します。Markdyはシステムモーションのために設計されています:リクエスト・レスポンスパス、キャッシュ無効化、イベントストリーミング、カメラフレーミング、ブラウザネイティブのWeb Animations APIを介してレンダリングされるステップバイステップのライフサイクルなどです。
いいえ。MarkdyはDOM要素、CSSトランスフォーム、Web Animations APIを使用しています。シーンは任意のDPIで鮮明で、軽量で、アクセス可能で、Astro、MDX、React、または静的ドキュメントサイト内でシームレスに実行されます。
はい!Markdyの行ベースの文法はLLM向けに設計されています。公式の@markdy/mcp-serverは、Cursor、Claude Desktop、Antigravityに接続し、リアルタイムでダイアグラムを検証、転写、自己修復します。