mermaid.design은 온라인 Mermaid 다이어그램 에디터입니다. 왼쪽에 Mermaid 문법을 작성하면 오른쪽에서 다이어그램이 실시간으로 렌더링됩니다. 모든 작업은 브라우저 안에서만 실행되며, 다이어그램은 절대 기기를 떠나지 않습니다.
첫 번째 다이어그램
- mermaid.design을 엽니다 — 예제 플로차트가 로드된 에디터가 표시됩니다.
- 왼쪽 창에서 Mermaid 코드를 편집합니다. 예:
flowchart TD
A[시작] --> B{준비됐나요?}
B -- 예 --> C[배포하기]
B -- 아니요 --> D[계속 코딩]
- 입력할 때마다 미리보기가 자동으로 다시 렌더링됩니다(짧은 디바운스 적용). 문법이 올바르지 않으면 오류 배너 뒤에 마지막으로 정상 렌더링된 다이어그램이 유지되고, 코드 에디터가 오류가 있는 줄을 표시합니다.
워크벤치
에디터는 세 개의 창으로 구성된 워크벤치입니다:
- 코드 에디터(왼쪽) — 가벼운 CodeMirror 에디터로, Mermaid 구문 강조, 인라인 오류 표시, 캔버스와의 선택 영역 동기화, 서식/복사/지우기 도구 모음을 제공합니다. 얇은 아이콘 스트립으로 접거나 구분선을 드래그해 크기를 조절할 수 있습니다.
- 미리보기(가운데) — 인터랙티브 다이어그램 캔버스입니다. 빈 영역을 드래그해 이동하고, Ctrl/⌘ + 스크롤 또는 핀치로 확대/축소하며, 화면 맞춤 버튼을 사용할 수 있습니다. 배경은 도트 / 화이트 / 체커 중에서 선택합니다.
- 테마 패널(오른쪽) — 원클릭 프리셋, 세부 테마 변수, 시드 컬러 기반 테마 생성을 제공합니다. 아래를 참조하세요.
좁은 화면에서는 워크벤치가 단일 창으로 바뀌고 하단에 코드 / 미리보기 / 테마 탭 바가 표시됩니다.
시각 편집 및 코드 도구
- 캔버스에서 편집 — 노드나 레이블을 더블 클릭해 텍스트를 수정하고 Enter를 누르거나 바깥을 클릭해 확정합니다. 엔터티를 클릭하면 편집 팝오버가 열리며, 다이어그램 유형에 따라 도형, 색상, 연결 및 기타 속성을 변경하거나 삭제할 수 있습니다.
- 양방향 선택 동기화 — 캔버스에서 엔터티를 선택하면 해당 Mermaid 소스가 강조 표시되고 해당 위치로 이동합니다. CodeMirror 커서를 엔터티 소스로 옮겨도 캔버스에서 선택됩니다.
- 공유 실행 취소 기록 — Ctrl/⌘+Z와 Ctrl/⌘+Shift+Z로 코드와 캔버스 변경을 하나의 기록에서 취소하거나 다시 실행합니다.
- 찾기 및 바꾸기 — Ctrl/⌘+F로 찾고 Ctrl/⌘+H로 바꾸기를 엽니다. 이전/다음, 대소문자 구분, 정규식, 단어 단위 일치, 개별/전체 바꾸기를 지원하며 결과는 캔버스에도 반영됩니다.
렌더링 모드
내비게이션 바의 세그먼트 컨트롤을 사용해 다이어그램 렌더링 방식을 전환하세요:
- 공식 — Mermaid 엔진이 렌더링하는 그대로의 표준 Mermaid SVG 출력입니다.
- ASCII — 다이어그램을 코드 주석, 문서, 터미널에 붙여 넣을 수 있는 텍스트 아트로 변환합니다. ASCII 렌더링을 참조하세요.
모드는 URL의 일부이므로 특정 모드의 링크를 북마크하거나 공유할 수 있습니다.
테마
모든 다이어그램은 base 테마와 70개 이상의 편집 가능한 테마 변수로 렌더링됩니다:
- 프리셋 — 11개의 Mermaid 기본 테마(Default, Neutral, Forest, Dark, Base 등)와 디자이너 프리셋이 미니 미리보기와 함께 제공됩니다.
- 테마 변수 — 검색 기능으로 그룹별 개별 색상, 테두리, 글꼴을 미세 조정합니다.
- 생성 — 하나의 시드 컬러에서 라이트 또는 다크의 완전한 테마를 생성합니다.
작업은 자동으로 저장됩니다
에디터는 코드, 테마, 레이아웃을 브라우저의 로컬 스토리지에 저장합니다. 탭을 닫았다가 나중에 돌아와도 다이어그램이 그대로 남아 있습니다. 서버에 업로드되는 것은 없습니다.