Markdown를 PDF로 변환이란?
Markdown to PDF는 마크다운 텍스트를 전문적으로 서식이 적용된 PDF 문서로 변환합니다. 제목, 목록, 코드 블록, 표가 포함된 마크다운을 붙여넣으면 공유하거나 인쇄할 수 있는 깔끔한 PDF를 다운로드할 수 있습니다.
에디터는 GitHub 스타일 Markdown을 해석하며, 언어 힌트가 붙은 펜스 코드 블록, 파이프 표, 작업 목록, 인라인 HTML을 지원합니다. Edit과 Preview를 오가거나, 가로폭이 넓은 화면에서는 분할 보기를 켜고 에디터와 미리보기를 좌우로 나란히 확인할 수 있습니다. 페이지 크기는 A4 또는 US 레터, 기본 본문 글꼴 크기는 8에서 20 pt 사이에서 고르고, 페이지 여백도 좁게·표준·넓게 중에서 골라 두면 제목과 고정폭 코드, 표 셀이 함께 자동으로 비례 조정됩니다. 결과는 다듬어진 PDF로 내보내거나, CMS·이메일에 그대로 붙여 넣을 수 있는 독립 HTML 파일로도 저장할 수 있습니다. 모두 기기 안에서 처리되므로, 원문이 외부로 나가지 않습니다.
사용 방법
- 에디터에 마크다운 내용을 붙여넣거나 직접 입력하세요 — 실시간 미리보기가 즉시 업데이트됩니다.
- 서식이 적용된 미리보기에서 제목, 목록, 코드 블록, 링크가 올바르게 렌더링되는지 확인하세요.
- PDF 다운로드를 클릭하여 서식이 적용된 문서를 기기에 저장하세요.
사용 시기
- README나 디자인 스펙을, .md 원본보다 PDF가 편한 비개발 리뷰어에게 보낼 때.
- 코드가 많은 튜토리얼을 들여쓰기 그대로 유지한 채 인쇄용 핸드아웃으로 만들 때.
- 회의록이나 리서치 보고서를 검색 가능한 PDF로, 원본 Markdown과 나란히 보관할 때.
결과
개발자가 프로젝트의 README.md를 붙여넣어 코드 예시와 API 엔드포인트 표가 포함된 고객 미팅용 PDF 핸드아웃을 만듭니다.
자주 묻는 질문
- PDF에서도 코드 블록의 구문 강조가 유지되나요?
- 네 — 언어 힌트가 붙은 펜스 코드 블록(```js, ```python, ```html, ```css, ```json, ```bash, ```sql 등)은 다운로드한 PDF에서도 키워드, 문자열, 주석, 숫자에 색이 입혀져 미리보기와 같은 모양으로 나옵니다. 언어 힌트가 없는 블록은 단색으로 유지됩니다.
- 내 컴퓨터에 있는 이미지를 넣을 수 있나요?
- 넣을 수 있습니다. 단, 이미지를 Markdown 안에 data URL(data:image/png;base64,...) 형태로 임베드해야 합니다. 공개 접근이 가능한 외부 URL도 됩니다. C:\photos\me.png 같은 로컬 경로는 PDF 렌더러가 디스크를 읽을 수 없어 불러오지 못합니다.
- 페이지보다 넓은 표는 어떻게 처리되나요?
- 렌더러가 표를 페이지 폭에 맞게 축소하기 때문에, 열이 빽빽한 표에서는 셀 글자가 크게 작아질 수 있습니다. 표가 매우 넓다면 A4로 내보낸 뒤 PDF를 가로로 회전하거나, 데이터를 더 좁은 표 두 개로 나누는 편이 낫습니다.
- PDF에 제목으로 만든 목차가 자동 생성되나요?
- 제목은 본문에 표시되지만 클릭 가능한 목차가 자동으로 만들어지지는 않습니다. 목차가 필요하면 Markdown에서 #로 시작하는 앵커 링크 목록을 직접 작성하세요. 대부분의 PDF 뷰어가 내보낸 파일에서도 이 링크를 유지합니다.
- Preview와 내려받은 PDF가 살짝 달라 보이는 이유가 뭔가요?
- Preview는 화면용 렌더러를 쓰지만, PDF는 html2pdf를 거쳐 인쇄 해상도로 다시 그리고 물리적인 페이지 분기를 따릅니다. 그래서 페이지 여백 근처의 긴 문단이나 이미지가 PDF에서는 한두 줄 정도 위아래로 이동할 수 있습니다.