다이어그램

Diagram 문서는 플로차트나 아키텍처 스케치를 그리는 캔버스입니다. 여러 모양의 노드, 노드를 잇는 엣지, 관련 노드를 묶는 그룹으로 이루어지고, ERD·Markdown 문서와 같은 프로젝트 트리에 들어갑니다.

다이어그램 만들기

File > New Document 를 열거나 프로젝트/폴더의 새 문서 동작을 누릅니다.
대상 프로젝트와, 필요하면 폴더를 고릅니다.
문서 타입으로 Diagram 을 선택합니다.
제목을 입력하고 만듭니다.

다이어그램은 탭으로 열립니다. 변경은 하는 즉시 저장되며, Ctrl+S / Cmd+S 는 모두 저장됐다는 확인만 보여 줍니다.

노드

Ctrl+N 을 누른 뒤 도형을 고르고 캔버스의 원하는 위치를 클릭합니다. Esc 로 취소합니다. 빈 캔버스를 오른쪽 클릭해 New Node 아래에서 도형을 골라도 됩니다.

도형	주 용도
원	시작
사각형	처리
둥근 사각형	활동
마름모	판단
스타디움	하위 프로세스
평행사변형	입력 / 출력
원기둥	데이터베이스
육각형	준비
이중 원	끝

노드를 선택하고 F2 를 누르면 그 자리에서 이름을 바꿉니다(Ctrl+Enter 저장, Esc 취소). 방향키는 선택한 노드를 8px, Shift+방향키는 40px 씩 옮깁니다.

노드를 오른쪽 클릭하면 Edit Node, Create Edge from Node, Duplicate, Focus, Copy / Cut, Add to Group, Change Color, Change Shape, Export Node, Delete Node 가 있습니다.

엣지

Ctrl+E 를 누르거나 캔버스 툴바의 Create Edge 를 누른 뒤 시작 노드, 이어서 대상 노드를 클릭합니다. Esc 로 취소합니다.

엣지 스타일 — Bezier(부드러운 곡선) 또는 Smooth Step(모서리가 둥근 직각). 다이어그램 전체 기본값은 캔버스 툴바에서, 엣지 하나는 개별로 바꿀 수 있습니다.
엣지를 오른쪽 클릭하면 Edit Edge, Change Style, Reverse Direction, Delete Edge 가 있습니다.

그룹

그룹은 관련 노드 주위에 색 상자를 그립니다. 노드 여러 개를 선택하고 툴바의 정렬 메뉴나 오른쪽 클릭 메뉴에서 Create Group 을 고르거나, 노드를 오른쪽 클릭해 Add to Group 을 씁니다.

그룹을 오른쪽 클릭하면 편집, 색 변경, 그룹 안만 자동 정렬, 내보내기, 삭제를 할 수 있습니다.

속성 패널

항목을 선택하고 오른쪽 레일의 Properties 를 엽니다.

선택	바꿀 수 있는 것
노드	텍스트, 도형, 채움 색, 테두리 색, 텍스트 색, 너비, 높이, 노트, 그룹
노드 여러 개	모두에 적용할 공통 도형
엣지	라벨, 스타일(Bezier / Smooth Step), 색, 라인 스타일(실선·파선·점선), 화살표(없음·화살표·열린 화살표)
그룹	이름, 색, 최소 너비·높이, 멤버 노드

오른쪽 레일에는 다른 문서 타입처럼 Versions 와 Share 도 있습니다.

캔버스 툴바

캔버스 위에 떠 있는 툴바(손잡이를 끌어 옮길 수 있음)에는 다음이 있습니다.

그리드 켜기/끄기 — 켜져 있으면 새로 놓거나 끈 노드가 격자에 맞춰집니다
Create Edge
Auto Layout — Horizontal, Vertical, Balanced, Compact, Tree
정렬 — 왼쪽·가운데·오른쪽·위·중간·아래 정렬, 가로·세로 균등 분배, Create Group (여러 개 선택 필요)
Edge Style — 다이어그램 기본 엣지 스타일
Undo / Redo
Fit to Screen
Export Image — PNG 또는 SVG
검색 — 노드·엣지·그룹을 텍스트로 찾기
Refresh

미니맵이 다이어그램 전체를 보여 주고, 상태 표시줄에 노드·엣지 개수, 확대 비율, 저장 상태가 나옵니다.

내보내기

이미지 — PNG 또는 SVG. 툴바의 Export Image 버튼, 또는 오른쪽 클릭 → Export Diagram.
JSON — 빈 캔버스 오른쪽 클릭 → Export Diagram → JSON.

노드 하나나 그룹 하나도 오른쪽 클릭 메뉴에서 같은 방식으로 내보낼 수 있습니다.

단축키

macOS 에서는 Ctrl 대신 Cmd 입니다.

단축키	동작
`Ctrl+N`	노드 추가 (도형 고른 뒤 캔버스 클릭)
`Ctrl+E`	엣지 만들기
`F2`	선택한 노드 이름 바꾸기
`Ctrl+C` / `Ctrl+V`	선택한 노드 복사 / 붙여넣기
`Delete` / `Backspace`	선택 항목 삭제
`Ctrl+Z`	실행 취소
`Ctrl+Shift+Z` / `Ctrl+Y`	다시 실행
`Ctrl+F`	검색
`Ctrl+0`	화면에 맞추기
`Ctrl+1` / `Ctrl+2`	100% / 200% 확대
방향키	선택한 노드 이동 (`Shift` 는 크게)
`Esc`	노드 배치·엣지 만들기·검색 취소

공유받은 다이어그램

읽기 전용으로 공유받은 다이어그램은 볼 수만 있고 바꿀 수 없습니다 — 편집 단축키를 누르면 안내만 뜹니다.

MCP 에서 다이어그램 다루기

다이어그램 문서는 일반 문서 도구로 만들고, 목록을 보고, 읽을 수 있습니다 — create_documents(type diagram), list_documents, get_document. MCP Tool Reference 를 참고하세요.