Mermaid 그림은 Live Editor나 mmdc로 PNG·SVG로 내보냅니다.
mmdc 명령을 실행하면 .mmd나 Markdown 파일을 SVG, PNG, PDF로 바꿀 수 있습니다. 렌더링 이미지 대신 편집 가능하고 학술지에 바로 낼 수 있는 버전이 필요하다면, SciFig 플로우차트(FlowChart)에서 AI가 설명을 바탕으로 다이어그램을 다시 그려 주며 모든 상자, 라벨, 화살표를 편집하고 SVG, PNG, PPTX로 내보낼 수 있습니다.Mermaid는 텍스트를 다이어그램으로 렌더링하므로 버전 관리하는 문서에 잘 맞습니다. 이 다이어그램을 논문 원고, 슬라이드, 포스터에 넣으려면 파일 형식과 크기를 따로 정해야 합니다. PNG의 픽셀 수가 부족하면 원하는 인쇄 크기에서 흐릿하게 보일 수 있습니다.
| 목적 | 방법 | 형식 | 설치 필요 여부 | 코드가 내 컴퓨터 밖으로 나가나요? |
|---|---|---|---|---|
| 다이어그램 하나를 지금 바로 | Mermaid Live Editor → Actions → PNG 또는 SVG | PNG, SVG | 아니요 | 예, 호스팅된 웹 페이지에 붙여 넣음 |
| 반복 또는 일괄 내보내기 | mermaid-cli(mmdc) | SVG, PNG, PDF | Node.js 또는 npx로 1회 실행 | 아니요, 로컬에서 렌더링 |
| Markdown 작성 중 미리보기 | VS Code 확장 프로그램 또는 Obsidian | 미리보기; 일부 확장 프로그램은 SVG/PNG 내보내기 | 편집기 확장 프로그램 | 아니요 |
| 항상 최신 상태인 문서 | CI 빌드 단계의 mmdc | SVG, PNG, PDF | 파이프라인 안 | CI 안에 머묾 |
| 편집 가능하고 학술지용인 재작도 | SciFig 플로우차트: 다이어그램을 설명하거나 Mermaid 텍스트를 .md 파일로 첨부하면 AI가 모든 상자, 라벨, 화살표를 편집할 수 있게 다시 그림 | SVG, PNG, JPG, PPTX | 아니요, 브라우저에서 실행 | 예, SciFig에 업로드 |
마지막 행은 종류가 다른 도구입니다. Mermaid 코드를 렌더링하는 대신 AI가 설명을 바탕으로 다이어그램을 네이티브 SVG로 다시 그리므로, 모든 노드, 라벨, 화살표가 옮기고 스타일을 바꾸고 학술지 관례에 맞게 배치할 수 있는 요소로 나옵니다. 카드 없이 무료로 시작할 수 있고 첫날 150 크레딧을 받으며, 편집과 SVG/PNG/PPTX 내보내기는 무료입니다.

명령줄에서 내보내기
@mermaid-js/mermaid-cli를 설치하면 mmdc 명령을 사용할 수 있습니다.npm install -g @mermaid-js/mermaid-cli
mmdc -i diagram.mmd -o diagram.svg # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3 # raster at 3x scale| 형식 | 벡터 지원 | 적합한 용도 | 피해야 할 경우 |
|---|---|---|---|
| SVG | 벡터 요소를 담는 형식 | 웹에 사용하거나 추가 편집할 때 | 사용할 곳에서 SVG를 지원하지 않을 때 |
| 벡터 요소를 담는 형식 | 논문 원고, 인쇄물, 슬라이드 | 가져올 편집기에서 필요한 요소를 유지하지 못할 때 | |
| PNG | 아니요 | 미리보기 또는 래스터 파일이 필요한 곳 | 최종 사용 크기에 비해 픽셀 수가 부족할 때 |
mmdc는 Markdown도 읽습니다. mmdc -i notes.md -o notes-rendered.md를 실행하면 파일 안의 모든 mermaid 코드 블록을 이미지로 렌더링하고, 그 이미지를 가리키는 Markdown 사본을 만듭니다. 다이어그램이 많은 README나 실험 노트에 편리합니다.Mermaid를 PNG로 내보내는 방법(흐릿하거나 작거나 잘린 출력 해결)
mmdc의 출력 파일 이름을 .png로 끝나게 지정하세요. PNG는 다이어그램 크기에 맞게 잘리며, 크기는 다이어그램을 배치하는 페이지 너비와 배율 두 가지 설정으로 정해집니다. “PNG가 이상하다”는 문제는 대부분 아래 해결법 중 하나로 풀립니다.-s는 레이아웃을 바꾸지 않고 픽셀 밀도를 배로 늘립니다. 슬라이드에는 -s 2, 인쇄에는 -s 3이나 -s 4가 적당합니다.mmdc -i diagram.mmd -o diagram.png -s 3-w는 페이지 너비(기본 800 px), -H는 페이지 높이(기본 600 px)를 정합니다. Mermaid는 넓은 다이어그램을 페이지에 맞게 줄이므로, 왼쪽에서 오른쪽으로 긴 플로우차트는 라벨을 읽기 어려울 만큼 작아질 수 있습니다. 페이지를 넓히면 라벨이 원래 크기로 유지됩니다.mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2graph LR 대신 graph TD).-b는 PNG와 SVG의 배경을 정합니다(PDF는 해당 없음). 기본값은 흰색입니다.mmdc -i diagram.mmd -o diagram.png -b transparent -s 3-c는 Mermaid용 JSON 설정을 불러오므로, 내보내는 모든 다이어그램이 같은 글꼴과 테마를 씁니다. -t는 한 번의 실행에 내장 테마(default, forest, dark, neutral)를 고릅니다.{
"theme": "neutral",
"themeVariables": { "fontFamily": "Arial" }
}mmdc -i diagram.mmd -o diagram.png -c config.json -s 3mmdc에 넘긴 테마를 사용합니다. 내보낸 결과가 미리보기와 다르다면 테마를 다이어그램 안에 적으세요.mmdc가 설치되지 않을 때: npx로 실행하세요. 관리가 엄격한 컴퓨터에서는 전역 설치가 실패합니다. npx는 CLI를 캐시에 내려받아 전역 설치 없이 한 번 실행합니다. 첫 실행 때는 헤드리스 브라우저도 내려받으므로 몇 분이 걸립니다.npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3타임라인과 시퀀스 다이어그램 예시
.mmd 파일로 저장하세요.timeline
title Research project timeline
2024 : Grant awarded
2025 : Pilot study : Data collection
2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3sequenceDiagram
participant R as Researcher
participant S as Sequencing core
participant P as Analysis pipeline
R->>S: Submit samples
S-->>R: Raw reads
R->>P: Run QC and alignment
P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg다른 환경에서 내보내기
mmdc는 명령줄 도구이므로 다이어그램 렌더링을 빌드 단계에 넣을 수 있습니다. 보통 .mmd 소스를 커밋하고 문서 빌드 때 이미지를 생성합니다. 이렇게 하면 이미지에도 해당 빌드의 소스 변경 사항이 반영됩니다.- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Obsidian, VS Code에서 내보내기와 논문·슬라이드에 넣기
mermaid 코드 블록을 렌더링하지만, 다이어그램 하나를 이미지 파일로 저장하는 기본 버튼은 없습니다. 노트를 PDF로 내보내면 다이어그램도 함께 들어갑니다. 단독 PNG나 SVG가 필요하면 코드 블록을 Mermaid Live Editor에 복사하거나, .mmd 파일로 저장해 mmdc를 실행하세요. mmdc는 Markdown을 읽으므로 노트 파일 자체를 지정해도 됩니다..mmd 파일로 두고 통합 터미널에서 mmdc로 렌더링하세요.-s 3 이상으로 사용하세요.
모양 조정하기
Mermaid의 기본 설정은 문서 작성에 맞춰져 있습니다. 논문이나 인쇄물에 사용하려면 다음 세 가지를 살펴보세요.
- 테마. 다이어그램의 YAML 프런트매터에서
config아래에theme: neutral을 설정하세요. 인쇄용 테마를 결정하기 전에 실제 사용 크기로 미리 확인하세요. - 글꼴. 설정의
fontFamily로 글꼴을 지정하고, 렌더링 환경에 해당 글꼴이 설치되어 있는지 확인하세요. - 방향.
graph LR과graph TD는 다이어그램의 가로세로 비율을 바꿉니다. 논문의 단 너비에 맞춰 넣을 때는 이 차이가 크게 작용합니다.
neutral 테마와 인쇄용 글꼴을 적용한 연구 과정 플로우차트 예시입니다.
---
config:
theme: neutral
fontFamily: Helvetica
---
graph LR
A[Sample collection] --> B[Extraction]
B --> C[Sequencing]
C --> D[Analysis]
Mermaid만으로 해결하기 어려운 경우
Mermaid는 요소 배치를 자동으로 계산하며, 사용자가 세밀하게 조절할 수 있는 범위는 제한적입니다. 문서에서는 편리하지만, 배치 자체가 의미를 전달하는 과학 그림에는 제약이 될 수 있습니다.
| Mermaid가 맞는 경우 | SciFig 플로우차트나 벡터 편집기로 바꿀 경우 |
|---|---|
| 버전 관리 안에 있는 문서 | 학술지의 시각적 관례에 맞춰야 하는 원고 그림 |
| 빌드할 때마다 다시 생성하는 다이어그램 | 상자 하나하나를 직접 제어하는 정밀한 배치 |
| 자동 배치로 충분한 경우 | 해부학적 위치나 시간 순서 같은 실제 관계를 반영하는 위치 |
| 검토 시 차이를 비교할 수 있는 텍스트 소스 | 코드가 아니라 화면에서 그림을 편집하는 공저자 |
Mermaid로 구조를 잡아 SVG로 내보낸 다음 벡터 편집기에서 마무리하는 방법도 있습니다. 다만 수작업으로 수정한 부분은 Mermaid 소스에서 다시 생성할 때 그대로 재현되지 않습니다.

.md 파일로 첨부하면, 텍스트 기반 다이어그램 생성기에서 AI가 편집 가능한 네이티브 SVG 버전을 그려 주며 모든 상자, 라벨, 화살표를 바로 옮기고 스타일을 바꿀 수 있습니다. 위의 시퀀스 예시 같은 상호작용은 시퀀스 다이어그램 생성기가 참여자와 메시지를 같은 방식으로 처리합니다. 첫날 150 크레딧으로 무료로 시작할 수 있고, 편집, 저장, SVG·PNG·PPTX 내보내기는 무료입니다. 같은 작업에 템플릿 기반 디자인 도구를 검토하고 있다면 다이어그램용 Canva 대안을 참고하세요.팁
.mmd 소스를 함께 커밋하세요. 소스는 변경 내용을 검토하기 쉽고 필요할 때 이미지를 다시 생성할 수 있습니다. 이미지는 결과를 바로 확인하는 데 유용합니다. 하나만 보관하면 변경 검토나 결과 확인 중 한쪽이 불편해집니다.함께 읽으면 좋은 글
관련 읽을거리: AI 텍스트에서 그림으로 연구 즉시 시각화, 2026년 최고의 과학 일러스트레이션 도구 10가지, 무료 캔바 대체 도구 7가지: 연구 다이어그램 비교 (2026).



