🎉 파이썬 개발자와 머메이드 팬들을 위한 큰 소식: 'mmdc'가 머메이드 다이어그램을 파이썬처럼 쉽게 만들다! 🚀

Source: Dev.to

Mermaid란 무엇인가?

Mermaid는 단순한 텍스트 기반 문법(Markdown과 매우 유사함)으로 다이어그램을 정의하고 이를 실제 다이어그램으로 렌더링해 주는 오픈‑소스 다이어그램 도구입니다.

다음과 같이 평문을 작성합니다:

graph TD
  A --> B
  B --> C

…그리고 Mermaid는 이를 시각적인 플로우차트로 변환해 문서, 위키, 블로그, 혹은 기술 문서에 삽입할 수 있게 해 줍니다. 배우기 쉽고, 버전 관리에 친화적이며, 다양한 도구와 통합됩니다. (Mermaid)

왜 mmdc가 혁신적인가

전통적으로 Mermaid를 SVG, PNG, PDF 등으로 변환하려면 다음이 필요했습니다:

• Node.js
• npm
• Mermaid CLI
• 브라우저 또는 헤드리스 워커
• 추가 시스템 도구

mmdc는 이 모든 것을 바꿉니다. 순수 Python 솔루션으로, pip install 한 번으로 설치할 수 있으며 외부 도구를 전혀 설치할 필요가 없습니다. 내부적으로 PhantomJS 인스턴스를 활용하는 강력한 라이브러리 Phasma를 사용해 Mermaid 코드를 실제 다이어그램 출력물로 렌더링합니다 — 별도로 뭔가를 설치할 필요가 없죠. 따라서 Python 환경, 자동화, 문서 파이프라인, CI/CD 워크플로에 최적입니다.

설치

pip install mmdc

이것만으로 준비 완료! Node.js, npm, apt 설치, 브라우저 등이 필요 없습니다.

명령줄에서 사용하기

간단한 Mermaid 파일을 SVG로 변환:

mmdc --input my_diagram.mmd --output my_diagram.svg

확장자를 지정하면 PNG 또는 PDF도 바로 만들 수 있습니다:

mmdc --input my_diagram.mmd --output my_diagram.png
mmdc --input my_diagram.mmd --output my_diagram.pdf

자동화된 문서 빌드, 정적 사이트 생성기, 블로그 파이프라인에 안성맞춤!

Python에서도 사용하기

Python 코드에서 직접 다이어그램을 생성:

from mmdc import MermaidConverter

converter = MermaidConverter()

mermaid_text = """
graph TD
    A[Start] --> B{Is it cool?}
    B -->|Yes| C[Love it!]
    B ---->|No| D[Try again]
"""

converter.to_svg(mermaid_text, output_file="cool_diagram.svg")

간단하고 강력하며, Python 애플리케이션, 문서 생성기, 노트북 워크플로, 자동화 스크립트와 깔끔하게 통합됩니다!

예시 Mermaid 코드 스니펫

Flowchart

graph LR
    A[Idea] --> B[Develop]
    B --> C[Test]
    C --> D[Deploy]

Simple Loop

flowchart TD
    Start --> Process
    Process --> Review
    Review -->|OK| End
    Review -->|Fix| Process

Sequence Diagram

sequenceDiagram
    Alice->>Bob: Hello Bob!
    Bob-->>Alice: Hi Alice!

왜 중요한가

• 외부 설정 불필요: Python 개발자는 이제 추가 설치 없이 Mermaid를 사용할 수 있습니다.
• 문서 자동화에 적합: Sphinx, MkDocs, Jupyter, 노트북, CI/CD와 잘 어울립니다.
• Python 중심 워크플로: 다이어그램을 코드베이스의 일급 구성 요소로 다룰 수 있습니다.

마무리

만약 Python 전용으로 Mermaid 다이어그램을 깔끔하게 생성하고 싶다면, mmdc는 큰 소식입니다. 단 한 번의 pip install으로 사랑받는 텍스트 기반 다이어그램 방식을 바로 Python 생태계에 가져다 줍니다.

이제 다이어그램을 코드 우선으로 만들 수 있습니다 — 버전 관리 가능하고, 자동화 가능하며, 가볍고 아름답게 — 외부 툴체인의 무게 없이. 💥