실용 가이드

순서도 생성기 — 사용 가이드 및 기술 원리

Mermaid 구문 및 비주얼 에디터로 순서도 및 다이어그램 생성

도구 열기

개요

Mermaid는 마크다운과 유사한 구문에서 다이어그램을 생성하는 텍스트 기반 다이어그램 도구입니다. 드래그 앤 드롭 편집기 대신 간단한 텍스트 설명을 사용하여 순서도, 시퀀스 다이어그램, 간트 차트, 클래스 다이어그램, 상태 다이어그램 등을 만들 수 있습니다. 구문은 키워드(graph, sequenceDiagram, gantt) 다음에 노드 정의 및 연결(A-->B, participant Alice)을 사용합니다. Mermaid는 다이어그램을 SVG 형식으로 렌더링하여 확장 가능하고 문서, 위키, 프레젠테이션에 포함할 수 있습니다. 이점에는 버전 제어(코드로서의 다이어그램), 쉬운 업데이트, 일관된 스타일링, 전문 다이어그램 소프트웨어 불필요 등이 있습니다. GitHub 마크다운, Notion, GitLab, Confluence 및 기술 문서에서 널리 사용됩니다.

핵심 개념

Mermaid 구문 기초

Mermaid 다이어그램은 유형 선언으로 시작합니다: graph TD(순서도 위에서 아래로), graph LR(왼쪽에서 오른쪽), sequenceDiagram, gantt, classDiagram, stateDiagram, erDiagram, pie. 노드는 다양한 모양에 대해 id[텍스트] 또는 id(텍스트)로 정의됩니다: [] 직사각형, () 둥근 모양, {} 마름모, (()) 원, [[]] 서브루틴. 연결은 화살표를 사용합니다: --> (실선), -.-> (점선), ==> (굵게), --텍스트--> (레이블). 서브그래프는 노드를 그룹화합니다: subgraph 제목 ... end. %%{init: {'theme':'dark'}}%% 또는 인라인 스타일 id:::className으로 스타일링. 주석은 %%로 시작합니다.

다이어그램 유형별 세부사항

순서도: 방향에 대해 graph TB/TD/BT/RL/LR 사용. 의사결정 노드(마름모), 프로세스(직사각형), 시작/종료(둥근 모양) 지원. 시퀀스 다이어그램: 참가자, 메시지(->>, -->>, -x), 활성화 박스(activate/deactivate), 노트(Note left/right of) 정의. 간트 차트: 시작 날짜, 기간, 종속성이 있는 작업 정의(after taskId). 클래스 다이어그램: 클래스, 속성, 메서드, 관계 정의(상속 <|, 구성 *--, 집계 o--). 상태 다이어그램: 상태, 전환, 선택 노드. 각 유형에는 특정 구문 규칙과 렌더링 로직이 있습니다.

렌더링 엔진

Mermaid.js 라이브러리는 텍스트 구문을 추상 구문 트리(AST)로 파싱한 다음 그래프 레이아웃을 위해 D3.js를 사용하여 SVG로 렌더링합니다. 레이아웃 알고리즘: 순서도용 Dagre(계층적 레이어 레이아웃), 유기적 모양용 force-directed. SVG 생성은 도형(<rect>, <circle>, <path>), 텍스트(<텍스트>), 커넥터(<line>, 마커가 있는 <path>)를 만듭니다. 테마는 SVG에 포함된 CSS 클래스를 통해 적용됩니다. 대화형 기능: 확대/축소/이동, 툴팁, 클릭 핸들러. 브라우저 렌더링은 mermaid.initialize()와 함께 <div class="mermaid">...code...</div>를 사용하거나 독립형 SVG 생성을 사용합니다.

고급 기능

Mermaid는 고급 다이어그래밍을 지원합니다: 서브그래프는 중첩 구조를 만듭니다. classDef 및 class로 스타일링하면 사용자 정의 CSS를 적용합니다. 링크: 클릭 nodeId "url"은 URL을 엽니다. 콜백: 클릭 nodeId callback은 JavaScript 함수를 트리거합니다. 노드의 FontAwesome 아이콘: fa:fa-icon. 따옴표를 사용한 레이블의 마크다운 형식화. 시퀀스는 루프(loop...end), 대안(alt/else/end), 병렬(par...end)을 지원합니다. 간트는 섹션, 마일스톤, 활성/done/crit 상태를 지원합니다. ER 다이어그램은 카디널리티(||--o{, 일대다)를 보여줍니다.

기능

다중 다이어그램 유형

순서도(graph TB/LR), 시퀀스 다이어그램, 간트 차트, 클래스 다이어그램, 상태 머신, ER 다이어그램, 파이 차트, 사용자 여정 맵을 유형별 구문 및 렌더링으로 지원합니다

이중 편집 모드

Mermaid 구문 강조, 자동 완성 및 오류 감지 기능이 있는 텍스트 편집기 또는 즉시 다이어그램 업데이트를 위한 양방향 코드 동기화가 있는 비주얼 드래그 앤 드롭 편집기(선택 사항)

사용자 정의 가능한 테마

내장 테마(기본, 포레스트, 다크, 뉴트럴) 중에서 선택하거나 브랜드에 맞는 일관된 다이어그램 모양을 위해 색상, 글꼴, 모양, 선 스타일, 노드 간격을 사용자 정의합니다

다중 형식 내보내기

다이어그램을 SVG(확장 가능한 벡터), PNG(사용자 정의 가능한 해상도의 래스터), PDF(인쇄/공유용)로 내보내거나 Mermaid 코드를 복사하여 마크다운 문서에 포함합니다

응용 시나리오

기술 문서

README 파일, 위키 및 기술 문서에서 시스템 아키텍처 다이어그램, API 순서도 및 프로세스 문서를 생성합니다. Mermaid 코드를 markdown에 직접 포함하여 GitHub, GitLab 및 Notion에서 자동으로 렌더링합니다.

프로젝트 관리

간트 차트를 사용하여 프로젝트 타임라인을 계획하고, 작업 종속성을 시각화하며, 마일스톤을 추적합니다. 버전 관리에서 추적할 수 있고 팀원과 쉽게 공유할 수 있는 텍스트 기반 다이어그램으로 프로젝트 계획을 업데이트합니다.

비즈니스 프로세스 문서

순서도를 사용하여 비즈니스 워크플로우, 승인 프로세스 및 사용자 여정 맵을 문서화합니다. 이해관계자와 프로세스 다이어그램을 공유하고 전문 다이어그램 소프트웨어 없이 피드백을 기반으로 쉽게 수정합니다.

소프트웨어 설계

클래스 다이어그램으로 소프트웨어 아키텍처를 설계하고, ER 다이어그램으로 데이터베이스 스키마를 모델링하며, 상태 다이어그램으로 상태 머신을 시각화합니다. 프로젝트와 함께 발전하는 코드로 설계를 반복합니다.

자주 묻는 질문

Mermaid란 무엇이며 왜 텍스트 기반 다이어그램을 사용하나요?

Mermaid는 마크다운과 유사한 구문에서 다이어그램을 생성하는 텍스트 기반 다이어그램 도구입니다. 그래픽 편집기 대신 텍스트를 사용하면 주요 이점이 있습니다: 버전 제어(다이어그램을 코드처럼 Git에서 추적 가능), 쉬운 협업(일반 텍스트 공유 및 편집), 자동화(프로그래밍 방식으로 다이어그램 생성), 일관성(테마가 균일한 스타일 보장), 전문 소프트웨어 불필요. 문서, 기술 작성 및 개발 워크플로우에 이상적입니다.

Mermaid로 어떤 유형의 다이어그램을 만들 수 있나요?

Mermaid는 여러 다이어그램 유형을 지원합니다: 순서도(프로세스 흐름, 의사결정 트리), 시퀀스 다이어그램(시스템 상호작용, API 호출), 간트 차트(프로젝트 타임라인), 클래스 다이어그램(UML 객체 모델), 상태 다이어그램(상태 머신), ER 다이어그램(데이터베이스 스키마), 파이 차트(비율 데이터), 사용자 여정 맵(사용자 흐름), Git 그래프(브랜치 히스토리). 각 유형에는 노드, 연결 및 속성에 대한 특정 구문이 있습니다.

문서 또는 프레젠테이션에서 사용할 다이어그램을 어떻게 내보내나요?

다이어그램을 여러 형식으로 내보낼 수 있습니다: SVG(확장 가능한 벡터 그래픽)는 모든 크기에서 선명한 렌더링 및 벡터 도구에서 편집 가능, PNG(래스터 이미지)는 문서 포함을 위한 사용자 정의 가능한 해상도, PDF는 인쇄 및 공유용, 또는 Mermaid가 기본적으로 지원되는 Markdown 파일, GitHub README, Notion 페이지, GitLab 위키, Confluence 문서에 포함하기 위해 Mermaid 코드를 직접 복사합니다.

다이어그램의 외관을 사용자 정의할 수 있나요?

예, Mermaid는 광범위한 사용자 정의를 제공합니다: 내장 테마(기본, 포레스트, 다크, 뉴트럴)는 전체 색 구성표를 변경합니다. classDef로 사용자 정의 CSS 클래스를 정의하고 노드에 적용할 수 있습니다. 개별 노드 스타일링은 사용자 정의 모양, 색상, 테두리 및 글꼴을 지원합니다. 연결 스타일은 선택적 레이블이 있는 실선, 점선 또는 굵은 화살표일 수 있습니다. 고급 사용자는 사용자 정의 CSS를 삽입하거나 테마 변수를 사용하여 브랜드 색상 및 디자인 시스템과 일치시킬 수 있습니다.

Mermaid는 모든 플랫폼에서 지원되나요?

Mermaid는 GitHub, GitLab, Notion, Confluence, VS Code, Obsidian 등 많은 플랫폼에서 기본적으로 지원됩니다. 지원되지 않는 플랫폼의 경우 다이어그램을 SVG 또는 PNG로 내보내 이미지로 포함할 수 있습니다. 웹 애플리케이션의 경우 Mermaid.js 라이브러리를 통합하여 클라이언트 측 렌더링을 활성화할 수 있습니다.

관련 문서

순서도 생성기

도구를 열어 이 기능을 사용해 보세요.

도구 열기