Mermaid
Mermaid CLI を導入
`npm i -g @mermaid-js/mermaid-cli` で `mmdc` を自動検出できます。
導入とダウンロード
最短なら Homebrew、手動管理なら DMG を選べます。
macOS で始めるための 2 つの明快なルート。
このページは app repository の現行手順に合わせて保守し、導入の最初の受け皿として機能させます。
01
Homebrew 推奨
02
直接ダウンロードも可
03
Gatekeeper 注意点あり
homebrew
Homebrew
最も短い導入ルートです。
- 通常はこちらを推奨します。
- インストール直後にそのまま利用できます。
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopmanual
手動ダウンロード
- GitHub Releases から最新の DMG を取得します。
- KatanA Desktop.app を Applications に移動します。
- 必要に応じて初回起動前に Gatekeeper 許可コマンドを 1 回実行します。
xattr -cr /Applications/KatanA\ Desktop.appupdates
アップデート方法
- KatanA にはアプリ内 auto-updater が入っています。
- 新しいリリースがある場合は、アプリ内の "Update & Restart" を使います。
- Homebrew から入れた場合でも、初回のアプリ内更新時に二重管理を避けるため自動的に Homebrew 管理から外れます。
diagram / setup
任意のダイアグラム設定
追加ツールが必要なのは Mermaid と PlantUML のみです。
PlantUML
Java runtime を導入
`brew install openjdk@25` を実行し、PlantUML ドキュメントを開いた時に `plantuml.jar` を取得します。
Draw.io
追加セットアップ不要
Draw.io 図は現行ガイダンスではネイティブに扱えます。
docs / links