mermaid2tgf

Mermaid에서 TGF로 변환

mermaid2tgf는 Mermaid 문법을 파싱하여 노드와 엣지 정보를 추출하고, 이를 TGF 형식의 텍스트 파일로 출력합니다. TGF 형식은 간단히 노드 정의와 엣지 정의로 구성되어 있어 다양한 그래프 처리 도구에서 쉽게 가져올 수 있습니다.

명령줄 인터페이스 제공

이 도구는 터미널에서 실행되는 명령줄 애플리케이션으로, 입력 Mermaid 파일 경로와 출력 TGF 파일 경로를 인수로 받아 변환 작업을 수행합니다. 별도의 그래픽 사용자 인터페이스 없이도 스크립트나 자동화 워크플로우에 쉽게 통합할 수 있습니다.

다운로드·설치 방법

mermaid2tgf는 Chocolatey 패키지 관리자를 통해 Windows에 설치할 수 있습니다. Chocolatey가 설치된 상태에서 관리자 권한으로 PowerShell 또는 명령 프롬프트를 열고 다음 명령을 실행하면 됩니다.

choco install mermaid2tgf

설치 후에는 시스템 경로에 등록되어 어디서든 ‘mermaid2tgf’ 명령을 실행할 수 있습니다.

기본 사용법/명령어

mermaid2tgf를 사용하는 기본 방법은 다음과 같습니다. 먼저 Mermaid 구문으로 작성된 다이어그램을 포함한 텍스트 파일을 준비합니다. 예를 들어, ‘diagram.mmd’라는 파일에 다음 내용을 저장할 수 있습니다.

graph TD
A[시작] –> B[처리]
B –> C[종료]

그런 다음 터미널에서 다음 명령을 실행하여 TGF 파일로 변환합니다.

mermaid2tgf diagram.mmd output.tgf

이 명령은 ‘diagram.mmd’ 파일을 읽어 Mermaid 다이어그램을 파싱하고, 결과를 ‘output.tgf’ 파일에 TGF 형식으로 저장합니다. 출력 파일을 확인하면 노드와 엣지가 TGF 형식으로 어떻게 표현되는지 볼 수 있습니다.

이런 경우에 유용합니다

Mermaid로 다이어그램을 설계했지만, TGF 형식을 지원하는 특정 그래프 분석 도구나 레거시 시스템에서 해당 다이어그램을 사용해야 하는 경우에 유용합니다. 예를 들어, 그래프 데이터베이스나 네트워크 분석 도구가 TGF 형식만 지원할 때, Mermaid로 설계한 워크플로우나 네트워크 다이어그램을 해당 도구로 가져올 수 있습니다.

지원 환경·시스템 요구사항

mermaid2tgf는 Node.js 환경을 필요로 하며, TypeScript로 작성되어 있습니다. 따라서 실행하려면 Node.js가 설치되어 있어야 합니다. Windows, macOS, Linux 등 Node.js가 지원하는 모든 플랫폼에서 사용할 수 있지만, Chocolatey 패키지는 현재 Windows 전용으로 제공됩니다.

최신 버전·업데이트

현재 버전은 1.0.0이며, 이는 초기 안정 버전을 나타냅니다. 소스 코드 저장소에서 최신 커밋 기록을 확인하면 버그 수정 및 소규모 개선 사항을 볼 수 있지만, 주요 기능 변경이 있는 업데이트 기록은 현재 제공되지 않습니다.