본문 바로가기

← Insights 생각 · 4분 · 읽음 25 · 추천 1 · 댓글 0

AI 시대의 문서에는 Mermaid 대신 SVG로 다이어그램을 그리세요

AI가 다이어그램을 그려 주는 시대에는 Mermaid의 편리함보다 SVG의 완성도를 택할 수 있습니다.

AI 시대의 문서에는 Mermaid 대신 SVG로 다이어그램을 그리세요 대표 이미지

다이어그램을 만드는 비용이 줄어든 시대, 이제는 결과물의 완성도를 고민해야 합니다.

개발 문서를 작성할 때 시스템 구조, 데이터 흐름, 알고리즘 등을 설명하려면 다이어그램이 필요합니다.

그동안 개발자들이 즐겨 사용했던 도구가 Mermaid입니다. 몇 줄의 텍스트만으로 다이어그램을 만들 수 있고, Markdown이나 GitHub에서도 활용할 수 있습니다.

하지만 Mermaid에는 분명한 한계가 있습니다.

복잡한 레이아웃을 원하는 대로 배치하기 어렵고, 색상이나 아이콘, 도형의 디자인을 정교하게 제어하기도 쉽지 않습니다.

그럼에도 Mermaid가 사랑받았던 이유는 단순합니다.

직접 그림을 그리는 것보다 훨씬 빠르고 편리했기 때문입니다.

그런데 생성형 AI가 등장하면서 상황이 달라졌습니다.

1. AI가 다이어그램을 그려주는 시대

SVG(Scalable Vector Graphics)는 벡터 기반 이미지 형식입니다.

도형의 위치, 크기, 색상, 곡선, 텍스트까지 자유롭게 제어할 수 있습니다. 확대해도 선명하고, 코드로 작성되기 때문에 Git으로 버전 관리하거나 프로그램으로 수정하는 것도 가능합니다.

문제는 제작 비용이었습니다.

과거에는 복잡한 SVG를 직접 작성하려면 수많은 좌표와 도형을 계산해야 했습니다. Mermaid보다 훨씬 번거로운 작업이었죠.

하지만 지금은 AI 에이전트가 SVG 코드를 직접 작성합니다.

"데이터 처리 과정을 가로형 다이어그램으로 만들고, 단계별 색상을 구분해 줘."

"화살표가 텍스트와 겹치지 않도록 수정해 줘."

"전체 디자인을 기존 문서의 스타일과 통일해 줘."

이러한 요구를 자연어로 전달하면 AI가 SVG를 생성하고 수정할 수 있습니다.

물론 결과물을 검토하는 과정은 필요하지만, 과거에는 사람이 직접 해야 했던 작업의 상당 부분을 자동화할 수 있게 되었습니다.

2. 이제는 제작 편의성보다 결과물의 품질

Mermaid는 빠르게 구조를 표현하는 데 강점이 있습니다. 하지만 최종 결과물의 시각적 완성도가 중요하다면 SVG가 더 유리할 수 있습니다.

구분 Mermaid SVG
빠른 구조 작성 매우 유리 가능
자동 레이아웃 강점 별도 구현 필요
디자인 자유도 제한적 매우 높음
정교한 위치 제어 제한적 자유로움
Git 버전 관리 가능 가능
AI 생성 및 수정 가능 가능
다른 콘텐츠에 재사용 가능 매우 유연

특히 SVG의 강점은 다이어그램을 일회성 그림이 아닌 재사용 가능한 자산으로 만들 수 있다는 것입니다.

하나의 SVG를 웹페이지, 기술 문서, 프레젠테이션, 교육 영상 등에 활용할 수 있습니다.

색상이나 텍스트를 일괄 변경할 수도 있고, AI 에이전트가 기존 SVG를 읽어 수정하도록 할 수도 있습니다.

잘 만들어진 SVG는 단순한 이미지가 아니라 지속적으로 관리하고 발전시킬 수 있는 문서 자산이 됩니다.

3. Mermaid를 버리자는 이야기는 아닙니다

Mermaid는 여전히 훌륭한 도구입니다.

단순한 흐름도를 빠르게 작성하거나, 구조 변경에 따라 자동으로 레이아웃을 구성할 때는 오히려 Mermaid가 효율적입니다.

따라서 다음과 같은 방식을 추천합니다.

  • 빠른 구조 설계: Mermaid 활용
  • 최종 배포용 다이어그램: SVG 활용
  • 복잡한 디자인과 시각화: AI 에이전트로 SVG 생성 및 수정
  • 지속적인 문서 관리: SVG를 코드와 함께 버전 관리

중요한 것은 무조건 SVG만 사용하자는 것이 아닙니다.

AI 덕분에 SVG 제작 비용이 크게 낮아졌으므로, 과거처럼 제작 편의성만을 기준으로 도구를 선택할 필요가 없어졌다는 것입니다.

4. AI 시대에는 도구를 선택하는 기준도 달라져야 합니다

과거에는 얼마나 쉽고 빠르게 만들 수 있는가가 중요했습니다.

정교한 다이어그램을 만드는 데 많은 시간이 필요했다면, 어느 정도 디자인을 포기하더라도 간편한 Mermaid를 선택하는 것이 합리적이었습니다.

하지만 이제는 질문을 바꿔야 합니다.

"이 다이어그램을 얼마나 빠르게 만들 수 있을까?"

보다는

"AI가 제작을 도와준다면, 얼마나 이해하기 쉽고 완성도 높은 결과물을 만들 수 있을까?"

Mermaid는 여전히 빠른 구조 표현에 강점이 있습니다. 그러나 문서의 가독성, 디자인, 재사용성까지 고려한다면 SVG를 더 적극적으로 활용할 이유가 충분합니다.

결국 AI 시대의 생산성은 단순히 작업 시간을 줄이는 것이 아닙니다.

같은 시간에 더 좋은 결과물을 만들어 내는 것.

이것이 제가 AI 시대의 기술 문서에서 SVG를 추천하는 이유입니다.


이 글은 위키독스 블로그에 처음 실었습니다.

댓글 0

첫 댓글을 남겨 주세요.