학습
Mermaid 다이어그램을 PDF로 내보내는 방법
Markdown 안의 Mermaid 다이어그램을 공유 후에도 읽기 쉬운 PDF로 내보내는 요령을 설명합니다.
게시 April 20, 2026·업데이트 April 20, 2026
PDF에서도 또렷한 Mermaid 다이어그램 만들기
Mermaid는 흐름도, 시퀀스 다이어그램, 아키텍처 개요를 표현하는 데 유용하지만, 도구를 옮겨 다니는 과정에서 깨질 때가 있습니다. Markdown 중심의 내보내기 흐름을 쓰면 다이어그램과 설명 문단을 더 자연스럽게 함께 유지할 수 있습니다.
가장 안전한 방법은 각 다이어그램을 설명하는 문단 가까이에 두는 것입니다. 그러면 내보낸 PDF가 나중에 스크린샷을 이어 붙인 문서가 아니라, 처음부터 하나의 문서로 읽히게 됩니다.
다이어그램을 더 잘 내보내는 팁
- 노드 라벨은 짧게 유지합니다.
- 너무 넓은 다이어그램은 가능하면 피합니다.
- 한 차트에는 한 가지 핵심만 담습니다.
- 다이어그램 앞뒤에 짧은 설명 문장을 둡니다.
추천 템플릿
Mermaid가 많은 문서에는 Creative가 잘 맞습니다. 시각 요소에 더 넉넉한 공간을 주어 다이어그램이 우연히 들어간 것처럼 보이지 않게 해 줍니다.