Mermaid 다이어그램, 한 줄 명령으로 예쁘게 뽑기
손쉽게 코드 기반으로 다이어그램을 생성해보세요
스킬 소개
이런 상황 겪어보셨나요
README에 architecture 그림 한 장만 박으면 좋겠다 싶어서 draw.io를 켰어요.
30분 뒤, 박스 정렬과 화살표 색을 맞추다가 본문 작성 시간을 다 써 버렸습니다.
결국 그림 없이 PR을 올렸어요.
설계 docs를 다크모드로 보는 팀원이 그림만 라이트모드 색이라 혼자 튄다고 합니다.
같은 다이어그램을 두 번 그리거나, 색을 다 갈아엎어 다시 export 해야 해요.
어느 쪽이든 1시간이 사라집니다.
코드 리뷰 코멘트에 흐름도 한 장이 필요한데, 이미지 첨부가 막혀 있어요.
PR 코멘트는 마크다운만 받습니다.
설명을 글로만 풀어 쓰니 리뷰어가 다시 머릿속에서 그림을 그려야 해요.
같은 흐름을 세 번째 설명할 때쯤 되면 본문보다 코멘트가 더 길어집니다.
진짜 불편한 지점
-
그림 도구를 켜는 데 시간이 너무 걸려요. draw.io, Figma, Excalidraw 모두 짧지 않은 진입 단계가 있고, 같은 그림을 다시 열어 고치는 것도 매번 비용입니다.
-
결과물이 코드처럼 버전 관리되지 않아요. PNG는 디프가 안 보이고, Figma 링크는 누가 언제 무엇을 바꿨는지 본문 안에서 추적할 길이 없어요.
