누가 할 수 있나요: 모든 사용자
어떤 플랜: Free, Starter, Business, Enterprise, Education
어떤 플랫폼: 브라우저, 데스크톱
Mermaid 코드를 사용해 다이어그램을 만들고, Miro 도형과 선처럼 편집하세요. Mermaid가 진실의 출처로 유지되므로 Miro, 코드베이스, AI 도구 간에 다이어그램을 옮겨도 구조가 유지됩니다.
레거시 Mermaid 앱에 대한 정보를 찾고 있다면 Miro용 Mermaid 다이어그램(레거시)을 참조하세요.
Miro에서 Mermaid 다이어그램을 사용하는 이유
- 기존 Mermaid 워크플로와 함께 사용 가능. 문서, PR, AI 채팅에 이미 작성하는 동일한 Mermaid 문법을 사용합니다. Miro MCP를 통해 에이전트가 보드에서 Mermaid 다이어그램을 생성, 읽기, 업데이트, 편집할 수 있습니다.
- Miro 도형으로 렌더링됨. Mermaid 코드는 편집 가능한 Miro 도형과 커넥터로 구성된 Diagram으로 변환되며, Miro가 자동으로 레이아웃을 지정합니다. 정적 이미지가 아닙니다. Miro는 Mermaid 버전 10과 11의 도형을 지원하므로, Mermaid Live나 Mermaid AI 또는 기타 도구에서 붙여넣은 다이어그램이 의도한 도형 유형으로 렌더링됩니다.
- 양방향 편집. 보드에서 다이어그램을 시각적으로 변경하면 Mermaid 코드가 업데이트됩니다. 코드를 편집하면 다이어그램이 다시 렌더링됩니다.
- 협업에 최적화됨. 다이어그램이 Miro의 기본 콘텐츠이므로 팀이 동일한 보드에서 실시간으로 댓글을 달고, 동시 편집하고, 반복 작업할 수 있습니다.
Mermaid 다이어그램 만들기
여러 가지 방법으로 Mermaid 다이어그램을 추가할 수 있습니다.
Mermaid 코드를 보드에 붙여넣기
- 편집기, 문서, 또는 AI 채팅에서 Mermaid 코드를 복사합니다.
- 보드에 붙여넣습니다.
Miro는 코드를 Miro 도형으로 구성된 Diagram으로 렌더링합니다.
코드에 문법 오류가 있으면 Miro가 캔버스에 피드백을 표시해 집중 모드를 열고 코드 패널에서 수정해야 함을 알려줍니다. 코드를 수정하면 다이어그램이 자동으로 렌더링됩니다.
Mermaid 파일 끌어다 놓기
- 컴퓨터에서 .mmd 또는 .mermaid 파일을 Miro 보드로 끌어다 놓습니다.
Miro는 해당 파일을 Miro 도형으로 구성된 Diagram으로 렌더링합니다.
업로드 가능한 전체 형식 목록은 지원되는 파일 형식을 참조하세요.
Miro MCP로 다이어그램 만들기
Miro MCP Server에 연결된 MCP 호환 AI 도구(예: Cursor 또는 Claude Code)를 사용해 보드에 Mermaid 다이어그램을 생성하세요.
- AI 툴을 Miro MCP에 연결합니다.
- 에이전트에게 특정 보드에 Mermaid 다이어그램을 만들라고 요청하세요. 기존 보드에 다이어그램을 만들려면 보드 URL을 프롬프트에 포함하세요.
- Miro에서 보드를 열어 렌더된 다이어그램을 검토하고 편집하며 협업하세요.
에이전트는 보드에서 Mermaid 코드를 읽어 다이어그램을 바로 업데이트할 수도 있어 코드베이스와 Miro 사이를 계속 반복 작업할 수 있습니다. 에이전트가 다이어그램을 편집하면 추가, 제거, 변경된 내용을 표시하는 범례를 추가할 수 있습니다.
Enterprise 플랜에서는 사용자가 연결하기 전에 회사 관리자가 Miro MCP를 활성화해야 합니다. 자세한 내용은 Miro MCP Server 관리자 가이드를 참조하세요.
다이어그램 형식에서 시작하기
- On a Miro board, open the 생성 바 and select 형식 > 다이어그램.
- Click 코드로 구축.
-
코드 패널에 직접 Mermaid 코드를 붙여넣거나 Mermaid 템플릿을 선택합니다.
다이어그램이 Miro 도형으로 렌더링됩니다. - 집중 모드 또는 캔버스에서 편집을 계속합니다.
다이어그램 형식, 집중 모드, 레이어, 템플릿에 대한 자세한 내용은 Miro 다이어그램을 참조하세요.
Mermaid 다이어그램 편집
보드에서 시각적으로, Mermaid 소스에서, 또는 AI(예: AI 팀원, 워크플로, Miro MCP)로 편집할 수 있습니다. 변경 사항은 동기화 상태로 유지됩니다.
시각적으로 편집
- 집중 모드에서 다이어그램을 엽니다.
-
다이어그램에서 도형, 선 또는 텍스트 레이블을 선택해 직접 편집합니다. 선택한 요소에 대한 제어가 포함된 툴바가 열립니다. 예: 도형 유형 변경, 텍스트 편집, 글꼴 크기 조정, 굵게 적용, 텍스트·테두리·채우기 색 설정.
- 코드 패널을 열어 Mermaid 구문이 일치하도록 업데이트되었는지 확인합니다.
도형 추가 및 연결
집중 모드에서는 Mermaid 코드를 편집하지 않고도 다이어그램을 확장할 수 있습니다:
- 도형을 추가하려면 클릭하세요. 도형 패널을 열고 도형을 클릭해 다이어그램에 추가하세요. 패널에는 Mermaid 플로차트 도형과 Miro의 표준 플로차트 도형이 포함되어 있습니다.
- 연결된 도형을 추가하세요. 도형을 선택한 다음 + 버튼을 클릭해 그 도형과 연결된 새 도형을 추가하세요.
- 도형을 연결하세요. 도형을 선택한 다음 + 버튼을 다른 도형 위로 드래그해 둘 사이에 선을 그리세요. 기존 선의 연결을 변경해 흐름을 바꿀 수도 있습니다.
레이아웃 조정
다이어그램 배치를 변경하려면 집중 모드에서 레이아웃 패널을 엽니다:
-
Under Direction, click an arrow to set the flow of the diagram: left to right, top to bottom, bottom to top, or right to left.
-
Under Spacing, drag the Horizontal and Vertical sliders to set the gap between shapes.
-
Under Shapes, choose how shapes are sized:
- Same width: All shapes share a uniform width for a neat, aligned layout.
- Fit to content: Each shape is sized to its text—useful when some shapes have much more text than others.
-
텍스트에서 레이블 배치를 선택합니다:
- 여러 줄: 긴 레이블은 여러 줄로 줄 바꿈됩니다.
- 한 줄: 각 레이블은 한 줄로 유지되어 도형이 더 넓어집니다.
코드 편집
- 다이어그램을 집중 모드에서 엽니다.
-
코드 패널을 엽니다.
-
Mermaid 구문을 업데이트합니다.
편집하는 동안 다이어그램이 실시간으로 다시 렌더링됩니다.
편집하는 동안:
- 도형과 코드는 서로 연결된 상태로 유지됩니다. 다이어그램에서 도형을 선택하면 해당 코드가 강조 표시되고, 코드를 선택하면 일치하는 도형으로 이동합니다.
- 구문 강조가 편집기에서 Mermaid 토큰에 색을 입혀 구조를 더 쉽게 파악할 수 있게 합니다.
- 편집할 때 더 많은 공간을 확보하려면 코드 패널의 크기를 조절할 수 있습니다.
코드 패널에서 설정 아이콘(톱니)을 클릭해 편집기의 코드 표시 방식을 조정합니다:
- 줄 번호: 편집기에서 줄 번호를 표시하거나 숨깁니다.
- 줄 바꿈: 긴 줄을 패널 너비에 맞춰 줄바꿈하여 가로 스크롤 없이 볼 수 있습니다.
AI로 편집
Mermaid 다이어그램을 AI 팀원, 워크플로, 또는 Miro MCP를 통해 연결된 에이전트와 함께 반복적으로 수정할 수 있습니다. 에이전트는 Mermaid 소스 코드를 읽고 편집하므로 다이어그램 전체를 재생성하지 않고도 정확한 변경을 수행할 수 있습니다.
AI 팀원 또는 워크플로 사용 시:
- 보드에서 다이어그램을 선택하거나 다이어그램 위젯의 링크를 복사합니다.
- AI 팀원을 열거나 워크플로를 실행합니다.
- 원하는 변경 사항을 요청합니다(예: “이 다이어그램의 모든 컨테이너를 빨간색으로 만들어 주세요”).
다이어그램이 바로 업데이트됩니다.
Miro MCP 사용 시:
- 다이어그램 위젯의 링크를 복사하세요.
- Miro MCP에 인증된 상태에서 사용 중인 AI 도구를 엽니다.
- 편집을 원하는 다이어그램 위젯의 링크를 붙여넣고 에이전트에게 변경을 요청하세요.
에이전트가 편집하는 동안 다이어그램이 그 자리에서 다시 렌더링됩니다.
시각적 편집과 코드 패널은 집중 모드에서만 사용할 수 있습니다. 캔버스에서 바로 분할 보기 편집은 지원되지 않습니다.
편집 기능 확장
도형이 더 필요하거나 도형을 자유롭게 이동하고 싶다면 다이어그램을 free-form으로 전환하세요. 이 작업은 도형 패널, 레이아웃 패널에서 시작하거나, 다이어그램에서 도형을 이동하려고 시도하면 시작할 수 있습니다.
-
도형을 이동해 보거나 도형 패널 또는 레이아웃 패널에서 자유 형식으로 전환을 선택합니다.
자유 형식 편집으로 전환 모달이 열립니다. -
전환 방법을 선택합니다:
- 전환하여 교체: 이 다이어그램을 자유 형식으로 변환합니다.
- 복사본을 만든 후 전환: 현재 Mermaid 버전은 유지하고 복사본을 자유 형식으로 변환합니다.
다이어그램을 자유 형식으로 전환하면 Mermaid 코드와 더 이상 동기화되지 않으며 MCP로 편집할 수 없습니다.
지원되는 다이어그램 유형
이 표는 각 Mermaid 다이어그램 유형이 Miro에서 어떻게 렌더링되는지 보여줍니다. 현재 집중 모드에서 플로차트는 시각적 편집이 가능하며, 다른 유형은 순차적으로 추가될 예정입니다:
| 다이어그램 유형 | 렌더러 | 시각적 편집 가능? |
|---|---|---|
| 플로차트 | Miro 도형 | 예 |
| 상태 | Miro 도형 | 곧 출시 예정 |
| 시퀀스 | Miro 도형 | 곧 출시 예정 |
| 클래스 | Miro 도형 | 곧 출시 예정 |
| ER (엔터티-관계) | Miro 도형 | 곧 출시 예정 |
| 기타 지원되는 Mermaid 다이어그램 | Mermaid SVG | 아니요 |
| Mermaid에서 지원되지 않는 다이어그램(예: 스윔레인) | 해당 없음 | 해당 없음 |
아직 시각적으로 편집할 수 없는 다이어그램 유형이 필요하면 이 양식에 피드백을 남겨 주세요. 인터뷰 요청을 위해 연락할 수 있습니다.
Mermaid 다이어그램 유형과 문법의 전체 목록은 공식 Mermaid 문서를 참조하세요.
공유 및 내보내기
- Miro MCP로 읽기. 연결된 에이전트에게 보드 URL에서 다이어그램을 읽어 코드베이스, PR 또는 기타 도구에 문서화하도록 요청하세요. Mermaid 소스는 나중에 다시 가져와 수정할 수 있도록 계속 유지됩니다.
- 링크 공유. 보드 URL을 복사하거나 다이어그램의 더보기 메뉴 (⋯)에서 집중 모드 링크 복사를 선택해 공동 작업자를 바로 다이어그램으로 보낼 수 있습니다. 자세한 내용은 보드 공유 및 공동 작업자 초대를 참조하세요.
- PDF 또는 이미지로 다운로드. 다이어그램의 더보기 메뉴 (⋯)에서 PDF로 내보내기 또는 이미지로 내보내기 (JPG, SVG 또는 PDF)를 선택하세요. 보드에서 다이어그램을 이미지로 복사할 수도 있습니다.
알려진 제한 사항
다음 현재 제약 사항을 염두에 두세요:
- 시각적 편집은 플로차트에만 제공됩니다. 상태, 시퀀스, 클래스, ER 다이어그램은 Miro의 네이티브 도형으로 렌더링되며, 해당 유형들에 대한 시각적 편집은 추후 제공될 예정입니다.
- 시각적 편집과 코드 패널은 집중 모드에서만 이용할 수 있습니다.
- 도형, 텍스트, 선에 대한 시각적 편집은 Mermaid 문법이 지원하는 범위로 제한됩니다.
- 다이어그램은 Miro의 네이티브 자동 레이아웃을 사용합니다. Mermaid 다이어그램에서는 도형을 자유롭게 이동할 수 없습니다.
기능 요청은 지속적으로 검토하므로, 이러한 제약 사항이 작업에 장애가 된다면 커뮤니티나 관리자에게 문의해 주세요.
추가 정보
- Mermaid 문법, 지원되는 다이어그램 유형 및 예제는 Mermaid 공식 문서를 참조하세요.
- 레이어, 컨테이너, 집중 모드와 같은 Diagram 형식의 기능은 Miro 다이어그램을 참조하세요.
- AI 도구를 Miro에 연결하는 방법은 Miro MCP Server 개요를 참조하세요.
- AI 팀원과 워크플로에 관해서는 AI 팀원 개요 및 워크플로 개요를 참조하세요.