마크다운 변환 가이드

마크다운 변환 도구는 작성한 마크다운을 실시간 미리보기와 함께 PDF 또는 DOCX 문서로 변환합니다. README나 기획 문서를 배포용 형식으로 바꿀 때 사용합니다.

사용 목적

이 도구는 README, 팀 기획 문서, 회의록처럼 마크다운으로 작성한 글을 다른 사람에게 공유하거나 인쇄해야 할 때 사용합니다. 개발자가 아닌 동료에게 넘길 핸드오프 문서를 PDF나 DOCX로 만들어, 마크다운 렌더러가 없는 환경에서도 작성한 그대로의 모습으로 보이게 하는 것이 목적입니다.

사용 순서

왼쪽 입력창에 마크다운을 붙여넣거나 작성합니다.
오른쪽 미리보기에서 렌더 결과를 확인합니다.
PDF 또는 DOCX 형식을 선택해 내보냅니다.

지원 문법

제목, 순서/무순서 목록, 체크박스
굵게·기울임·인라인 코드·링크 등 인라인 서식
인용문(blockquote), 표
Mermaid 다이어그램
LaTeX 수식 — 인라인 $...$·$...$, 블록 $$...$$·\[...\](미리보기·PDF·DOCX 지원)

옵션 선택 기준

PDF는 인쇄나 고정된 레이아웃 공유(외부 발표 자료, 계약 문서 등)에 적합합니다. 뷰어 프로그램과 무관하게 항상 같은 모양으로 보이기 때문입니다.
DOCX는 받는 사람이 내용을 다시 편집해야 할 때(리뷰 코멘트, 공동 수정) 적합합니다.
미리보기는 최종 출력 전에 렌더링 결과(표, 다이어그램, 수식 포함)를 확인하는 용도이므로, 내보내기 전에 반드시 확인하는 것이 좋습니다.
Mermaid 렌더링은 미리보기·PDF·DOCX 모두에서 동일하게 적용되므로, 흐름도나 시퀀스 다이어그램이 포함된 문서는 어떤 형식을 고르든 다이어그램이 유지됩니다.

실패·주의 케이스

Mermaid 코드에 문법 오류가 있으면 다이어그램이 그려지지 않고, 그 자리에 오류 메시지와 원본 코드가 표시됩니다. 미리보기·PDF·DOCX 모두 오류 메시지와 원본 코드를 포함해 보여주며, 나머지 내용은 정상적으로 변환됩니다.
문서가 매우 길면(수십 페이지 분량) 미리보기 렌더링과 PDF 생성에 시간이 더 걸릴 수 있으니, 분량이 큰 문서는 섹션 단위로 나눠 작업하는 것을 권장합니다.
PDF에는 한글 폰트에 없는 화살표·체크 표시·수학 기호 같은 특수 글리프가 자동으로 비슷한 모양의 ASCII 문자로 치환됩니다(예: → 는 ->로 표시). 미리보기와 DOCX에는 이 치환이 적용되지 않아 PDF와 다르게 보일 수 있습니다.
코드 블록 한 줄이 너무 길면 PDF 페이지 폭을 넘어갈 수 있습니다. 긴 코드는 줄바꿈하거나 핵심 부분만 포함해야 읽기 좋습니다.

예시 시나리오

Mermaid가 포함된 README → PDF 핸드오프: 마크다운을 작성하고 미리보기에서 다이어그램을 확인한 뒤 PDF로 내보내면, 외부 파트너에게 고정된 형태로 전달할 수 있습니다.
다듬어지지 않은 기획 초안 → DOCX 리뷰용: 초안을 마크다운으로 작성하고 DOCX로 내보내면, 리뷰어가 워드에서 코멘트를 달거나 직접 수정할 수 있습니다.

팁

미리보기 스타일과 PDF 출력 스타일은 동일하게 적용됩니다(WYSIWYG).
한글 폰트가 포함되어 PDF에서도 한글이 깨지지 않습니다.

자주 묻는 질문

Q. 지원하지 않는 문법을 넣으면 어떻게 되나요?
표준 마크다운·GFM 문법(제목, 목록, 표, 인용문, 인라인 서식 등) 이외의 문법은 별도 오류 없이 입력한 텍스트가 그대로 표시됩니다.

Q. Mermaid 다이어그램이 안 그려져요.
다이어그램 문법에 오류가 있으면 해당 위치에 "Mermaid 오류" 메시지와 원본 코드가 표시됩니다. 코드를 수정하면 자동으로 다시 렌더링됩니다.

Q. 파일이 서버로 전송되나요?
아니요. 마크다운 읽기, 미리보기 렌더링, PDF·DOCX 생성까지 모두 브라우저 안에서 처리되며 외부 서버로 전송되지 않습니다.

Q. Mermaid가 실패하면 어떻게 확인하나요?
다이어그램이 그려져야 할 자리에 오류 메시지와 원본 코드가 함께 표시됩니다. 미리보기에서 바로 확인할 수 있으며, 코드를 수정하면 즉시 다시 렌더링을 시도합니다.

Q. PDF와 DOCX 중 어떤 형식을 고르면 되나요?
고정된 레이아웃으로 보여주거나 인쇄해야 한다면 PDF를, 받는 사람이 내용을 다시 편집해야 한다면 DOCX를 선택하세요.