Mermaid
추가 설정 불필요
Mermaid 다이어그램과 ZenUML 시퀀스 다이어그램은 현재 문서 흐름에서 렌더링됩니다.
지원 플랫폼
macOS / Windows x86_64 / Linux x86_64
macOS용 Homebrew/DMG, Windows용 Winget/MSI, Linux용 Homebrew/tar.gz 지원.
macOS
macOS + Homebrew
macOS에서 가장 빠르고 간편한 권장 설치 방법입니다.
- 공식 README에서 권장하는 방법입니다.
- 설치 후 즉시 앱을 시작할 수 있습니다.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopmacOS 수동 다운로드
- GitHub Releases에서 최신 `KatanA-Desktop-x.y.z.dmg`를 받으세요.
- `KatanA Desktop.app`을 응용 프로그램 폴더로 옮깁니다.
- 첫 실행 시 Gatekeeper 경고가 뜨면 명령어를 실행해야 할 수 있습니다.
- macOS Sequoia (15.x)의 경우 공증되지 않은 빌드에 대해 이 명령어가 필요할 수 있습니다. 또는 시스템 설정 > 개인정보 보호 및 보안에서 수동 허용이 가능합니다.
xattr -cr /Applications/KatanA\ Desktop.appWindows x86_64
Windows에서는 Winget이 가장 빠릅니다. GitHub Releases에서 MSI도 지원합니다.
- Winget으로 설치하거나 GitHub에서 `KatanA-windows-x86_64.msi`를 받으세요.
- MSI 파일을 실행하여 설치를 완료합니다.
- 시작 메뉴와 바탕화면에 바로가기가 자동으로 생성됩니다.
winget install HiroyukiFuruno.katana-desktopLinux x86_64
가능하다면 Homebrew 사용을 권장합니다. GitHub에서 tar.gz로도 제공됩니다.
- Homebrew로 설치하거나 `KatanA-linux-x86_64.tar.gz`를 받으세요.
- 아카이브 압축을 해제합니다.
- 바이너리를 직접 실행하세요.
brew tap HiroyukiFuruno/KatanA && brew install katana-desktop업데이트 정보
- KatanA는 스마트한 내장 업데이트 기능을 제공합니다.
- macOS에서는 앱 내의 "Update & Restart" 버튼을 사용하세요.
- Windows/Linux는 업데이트 알림창을 통해 최신 릴리스로 안내합니다.
- macOS에서 Homebrew로 설치한 경우, 첫 업데이트 시 충돌을 피하기 위해 Homebrew 관리에서 자동으로 분리됩니다.
선택적 다이어그램 설정
Mermaid와 ZenUML은 추가 설정 없이 사용하고, PlantUML만 필요에 따라 런타임을 준비합니다.
PlantUML
Java 런타임 설치
`brew install openjdk@25` 설치 후, 앱에서 PlantUML 문서를 열 때 `plantuml.jar`를 내려받으세요.
Draw.io
추가 설정 불필요
Draw.io 다이어그램은 기본적으로 내장 지원됩니다.
설치 후
설치 후 3가지 확인
- 워크스페이스 열기: 트리에서 README와 스펙 파일이 보이는지 확인.
- 다이어그램 확인: Mermaid 문서(ZenUML 시퀀스 다이어그램 포함) 또는 PlantUML 문서 렌더링 확인.
- 업데이트 확인: 앱 내 업데이트 확인을 1회 실행.
지원
FAQ
PlantUML이 보이지 않음
Java 런타임 설치 후 plantuml.jar 다운로드를 허용하세요.
macOS에서 앱이 차단됨
Privacy & Security의 Open Anyway 또는 xattr 명령을 1회 사용하세요.