미국 태평양 시간 12월 1일 종료
SciFig
튜토리얼··업데이트됨

Mermaid 변환: SVG·PNG·PDF 내보내기 (2026)

Mermaid 변환으로 PNG·SVG·PDF 내보내기: Live Editor, mermaid-cli, VS Code, CI 사용법과 흐릿하거나 작거나 잘린 PNG 해결법.

SciFig Team
SciFig Team
SciFig 편집팀

Mermaid 그림은 Live Editor나 mmdc로 PNG·SVG로 내보냅니다.

빠른 답: 다이어그램 하나만 이미지로 변환한다면 Mermaid Live Editor에 붙여 넣고 Actions 패널에서 PNG나 SVG를 다운로드하세요. 반복 또는 일괄 내보내기에는 mermaid-cli의 mmdc 명령을 실행하면 .mmd나 Markdown 파일을 SVG, PNG, PDF로 바꿀 수 있습니다. 렌더링 이미지 대신 편집 가능하고 학술지에 바로 낼 수 있는 버전이 필요하다면, SciFig 플로우차트(FlowChart)에서 AI가 설명을 바탕으로 다이어그램을 다시 그려 주며 모든 상자, 라벨, 화살표를 편집하고 SVG, PNG, PPTX로 내보낼 수 있습니다.
아무것도 설치하지 않고 Mermaid 다이어그램을 이미지로 저장하려면 코드를 SciFig Mermaid PNG 변환 도구에 붙여 넣으세요. 브라우저에서 다이어그램을 렌더링하고, 1×~4× 내보내기 배율과 흰색 또는 투명 배경을 고른 뒤 PNG나 SVG를 무료로 다운로드할 수 있습니다.

Mermaid는 텍스트를 다이어그램으로 렌더링하므로 버전 관리하는 문서에 잘 맞습니다. 이 다이어그램을 논문 원고, 슬라이드, 포스터에 넣으려면 파일 형식과 크기를 따로 정해야 합니다. PNG의 픽셀 수가 부족하면 원하는 인쇄 크기에서 흐릿하게 보일 수 있습니다.

목적방법형식설치 필요 여부코드가 내 컴퓨터 밖으로 나가나요?
다이어그램 하나를 지금 바로Mermaid Live Editor → Actions → PNG 또는 SVGPNG, SVG아니요예, 호스팅된 웹 페이지에 붙여 넣음
반복 또는 일괄 내보내기mermaid-cli(mmdc)SVG, PNG, PDFNode.js 또는 npx로 1회 실행아니요, 로컬에서 렌더링
Markdown 작성 중 미리보기VS Code 확장 프로그램 또는 Obsidian미리보기; 일부 확장 프로그램은 SVG/PNG 내보내기편집기 확장 프로그램아니요
항상 최신 상태인 문서CI 빌드 단계의 mmdcSVG, PNG, PDF파이프라인 안CI 안에 머묾
편집 가능하고 학술지용인 재작도SciFig 플로우차트: 다이어그램을 설명하거나 Mermaid 텍스트를 .md 파일로 첨부하면 AI가 모든 상자, 라벨, 화살표를 편집할 수 있게 다시 그림SVG, PNG, JPG, PPTX아니요, 브라우저에서 실행예, SciFig에 업로드

마지막 행은 종류가 다른 도구입니다. Mermaid 코드를 렌더링하는 대신 AI가 설명을 바탕으로 다이어그램을 네이티브 SVG로 다시 그리므로, 모든 노드, 라벨, 화살표가 옮기고 스타일을 바꾸고 학술지 관례에 맞게 배치할 수 있는 요소로 나옵니다. 카드 없이 무료로 시작할 수 있고 첫날 150 크레딧을 받으며, 편집과 SVG/PNG/PPTX 내보내기는 무료입니다.

Mermaid 플로우차트의 소스 텍스트와 렌더링한 SVG를 나란히 비교한 예시(SciFig로 생성한 그림)
Mermaid 플로우차트의 소스 텍스트와 렌더링한 SVG를 나란히 비교한 예시(SciFig로 생성한 그림)

명령줄에서 내보내기

공식 도구인 @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나 PDF를 우선 선택하세요. 벡터 선과 글자는 확대해도 선명하지만, 파일 안에 포함된 래스터 이미지는 원래 해상도를 그대로 유지합니다. PNG는 배율을 지정한 뒤, 출력 파일의 픽셀 크기가 필요한 인쇄 크기와 해상도에 맞는지 확인하세요.
형식벡터 지원적합한 용도피해야 할 경우
SVG벡터 요소를 담는 형식웹에 사용하거나 추가 편집할 때사용할 곳에서 SVG를 지원하지 않을 때
PDF벡터 요소를 담는 형식논문 원고, 인쇄물, 슬라이드가져올 편집기에서 필요한 요소를 유지하지 못할 때
PNG아니요미리보기 또는 래스터 파일이 필요한 곳최종 사용 크기에 비해 픽셀 수가 부족할 때
mmdc는 Markdown도 읽습니다. mmdc -i notes.md -o notes-rendered.md를 실행하면 파일 안의 모든 mermaid 코드 블록을 이미지로 렌더링하고, 그 이미지를 가리키는 Markdown 사본을 만듭니다. 다이어그램이 많은 README나 실험 노트에 편리합니다.

AI 과학 그림 생성을 직접 확인하세요

연구자들이 텍스트 설명만으로 출판 가능한 과학 그림을 만드는 과정을 확인하세요.

도구 살펴보기

Mermaid를 PNG로 내보내는 방법(흐릿하거나 작거나 잘린 출력 해결)

Mermaid 다이어그램으로 PNG 파일을 만들려면 mmdc의 출력 파일 이름을 .png로 끝나게 지정하세요. 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 2
잘리거나 눌린 출력: 먼저 SVG로 내보내세요. 라벨이 잘리거나 빽빽하다면 SVG로 렌더링해 브라우저에서 열어 보세요. SVG가 정상이라면 페이지 크기나 배율 문제이고, SVG도 이상하다면 라벨을 줄이거나 방향을 바꾸세요(graph 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 3
편집기 테마는 따라오지 않습니다. VS Code의 어두운 테마, Obsidian의 다크 모드, 편집기 UI에서 고른 테마는 미리보기 모양만 바꿉니다. 내보낸 파일은 다이어그램 안에 적힌 테마(init 줄이나 프런트매터) 또는 mmdc에 넘긴 테마를 사용합니다. 내보낸 결과가 미리보기와 다르다면 테마를 다이어그램 안에 적으세요.
mmdc가 설치되지 않을 때: npx로 실행하세요. 관리가 엄격한 컴퓨터에서는 전역 설치가 실패합니다. npx는 CLI를 캐시에 내려받아 전역 설치 없이 한 번 실행합니다. 첫 실행 때는 헤드리스 브라우저도 내려받으므로 몇 분이 걸립니다.
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

타임라인과 시퀀스 다이어그램 예시

아래 최소 예시도 같은 명령으로 내보낼 수 있습니다. 각각 .mmd 파일로 저장하세요.
Mermaid 타임라인 예시(이미지/PNG):
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 3
Mermaid 시퀀스 다이어그램 예시:
sequenceDiagram
    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

다른 환경에서 내보내기

Mermaid Live Editor. 브라우저 편집기는 Actions 패널에서 SVG와 PNG를 바로 내보낼 수 있어 다이어그램 하나를 만들 때 가장 빠릅니다. 다만 다이어그램을 호스팅 서비스에 붙여 넣어야 하므로 민감한 내용이라면 이 점을 고려하세요.
SciFig Mermaid PNG 변환 도구. Mermaid 코드를 Mermaid PNG 변환 도구에 붙여 넣고 미리보기를 렌더링한 뒤 PNG나 SVG를 다운로드합니다. PNG를 더 선명하게 하려면 1×~4× 중 높은 배율을, 색이 있는 슬라이드에 올릴 때는 투명 배경을 고르세요. 코드에 문법 오류가 있으면 깨진 이미지를 내보내는 대신 오류 위치를 알려 주므로, 해당 줄을 고친 뒤 다시 렌더링하면 됩니다.
VS Code. Mermaid 미리보기 확장 프로그램을 사용하면 문서를 작성하면서 다이어그램을 바로 확인할 수 있습니다. 내보내기 기능은 확장 프로그램마다 다릅니다. SVG, PNG, PDF 중 원하는 형식으로 확실하게 출력하려면 위의 CLI 명령을 사용할 수 있습니다.
CI 파이프라인. mmdc는 명령줄 도구이므로 다이어그램 렌더링을 빌드 단계에 넣을 수 있습니다. 보통 .mmd 소스를 커밋하고 문서 빌드 때 이미지를 생성합니다. 이렇게 하면 이미지에도 해당 빌드의 소스 변경 사항이 반영됩니다.
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
저장소에 커밋한 Mermaid 소스로 문서 빌드 중 이미지를 생성하는 CI 파이프라인 예시(SciFig로 생성한 그림)
저장소에 커밋한 Mermaid 소스로 문서 빌드 중 이미지를 생성하는 CI 파이프라인 예시(SciFig로 생성한 그림)

Obsidian, VS Code에서 내보내기와 논문·슬라이드에 넣기

Obsidian. Obsidian은 노트 미리보기에서 mermaid 코드 블록을 렌더링하지만, 다이어그램 하나를 이미지 파일로 저장하는 기본 버튼은 없습니다. 노트를 PDF로 내보내면 다이어그램도 함께 들어갑니다. 단독 PNG나 SVG가 필요하면 코드 블록을 Mermaid Live Editor에 복사하거나, .mmd 파일로 저장해 mmdc를 실행하세요. mmdc는 Markdown을 읽으므로 노트 파일 자체를 지정해도 됩니다.
VS Code와 Markdown 미리보기. Mermaid 미리보기 확장 프로그램은 입력하는 대로 다이어그램을 보여 줍니다. VS Code에서 Markdown 안의 Mermaid 다이어그램을 PNG로 내보내려면 내보내기를 지원하는 확장 프로그램을 쓰거나, 다이어그램을 Markdown 옆의 .mmd 파일로 두고 통합 터미널에서 mmdc로 렌더링하세요.
논문과 슬라이드. PNG가 아니라 SVG(LaTeX라면 PDF)로 내보내세요. PowerPoint에서는 SVG를 그림으로 삽입하면 되고, 최신 버전은 이를 도형으로 변환해 상자 색을 바꿀 수 있습니다. Illustrator나 Inkscape에서는 SVG를 열어 간격, 글꼴, 화살촉을 조정한 뒤 원고에 배치하세요. PNG는 투고 시스템이 벡터 파일을 받지 않을 때만 -s 3 이상으로 사용하세요.
같은 Mermaid 플로우차트에 기본 테마와 neutral 테마를 적용해 인쇄 시 가독성을 비교한 예시(SciFig로 생성한 그림)
같은 Mermaid 플로우차트에 기본 테마와 neutral 테마를 적용해 인쇄 시 가독성을 비교한 예시(SciFig로 생성한 그림)

모양 조정하기

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 소스에서 다시 생성할 때 그대로 재현되지 않습니다.

Mermaid의 자동 배치와 논문용 그림에 맞춰 수동으로 재배치한 결과를 비교한 예시(SciFig로 생성한 그림)
Mermaid의 자동 배치와 논문용 그림에 맞춰 수동으로 재배치한 결과를 비교한 예시(SciFig로 생성한 그림)
다른 방법은 SciFig 플로우차트(FlowChart)로 다시 그리는 것입니다. 다이어그램을 평이한 말로 설명하거나 Mermaid 텍스트를 .md 파일로 첨부하면, 텍스트 기반 다이어그램 생성기에서 AI가 편집 가능한 네이티브 SVG 버전을 그려 주며 모든 상자, 라벨, 화살표를 바로 옮기고 스타일을 바꿀 수 있습니다. 위의 시퀀스 예시 같은 상호작용은 시퀀스 다이어그램 생성기가 참여자와 메시지를 같은 방식으로 처리합니다. 첫날 150 크레딧으로 무료로 시작할 수 있고, 편집, 저장, SVG·PNG·PPTX 내보내기는 무료입니다. 같은 작업에 템플릿 기반 디자인 도구를 검토하고 있다면 다이어그램용 Canva 대안을 참고하세요.

팁

내보낸 이미지와 .mmd 소스를 함께 커밋하세요. 소스는 변경 내용을 검토하기 쉽고 필요할 때 이미지를 다시 생성할 수 있습니다. 이미지는 결과를 바로 확인하는 데 유용합니다. 하나만 보관하면 변경 검토나 결과 확인 중 한쪽이 불편해집니다.

지금 과학 그림 만들기

과학 그림을 자연어로 설명하세요 — 출판 가능한 일러스트를 단 몇 분 만에 받아보세요.

무료로 체험하기
다이어그램을 넘어서는 논문용 그림은 텍스트로 과학 그림 만들기로 일러스트를 만들 수 있습니다. 전체 작업 흐름은 연구 시각화 가이드에서 확인할 수 있습니다.

함께 읽으면 좋은 글

관련 읽을거리: AI 텍스트에서 그림으로 연구 즉시 시각화, 2026년 최고의 과학 일러스트레이션 도구 10가지, 무료 캔바 대체 도구 7가지: 연구 다이어그램 비교 (2026).

자주 묻는 질문

이어서 살펴보기

추천 리소스

연구에 도움이 되는 템플릿, 도구, 관련 읽을거리

콜투액션 배경

시작할 준비가 되셨나요?

출판 가능한 과학 그림, 단 몇 분 만에

무료로 만들기 시작하기

무료로 시작 · 신용카드 필요 없음 · 연구자를 위한 도구