HN 日本語サマリー

← 一覧へ戻る
プログラミング

Markdy: Mermaidダイアグラムのように、しかし動きのために

Markdy: Like Mermaid Diagrams, but for Motion (markdy.com)

16 pointsby surprisetalk0 コメント

要約

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レビューのために構築されたダイアグラムレイヤー。

### ダイアグラムネイティブDSLとモーション

セマンティックノード、グループ、フロー、タイムドビートをレビュー可能なテキストで宣言します。レイアウト、衝突回避、振り付けは100%自動です。

詳細はこちら ↗

### ユニバーサル取り込み

Mermaidフローチャート、Draw.io XML、Docker Compose、Kubernetes YAML、Terraform状態からアニメーションシーンへの1クリック転写。

詳細はこちら ↗

### AIネイティブ&MCPサーバー

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の連携方法
  1. ホストされたエージェント参照

    markdy.com/AGENT.md または llms.txt をコーディングアシスタントと共有します。

  2. 自然言語でのプロンプト

    「RedisとPostgresを使ったキャッシュアサイドアーキテクチャ図を描いてください。」

  3. 自律的な自己修復ループ

    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に接続し、リアルタイムでダイアグラムを検証、転写、自己修復します。