Markdown을 PDF로 변환하는 방법 (무료, 코드 블록·표 그대로)

Markdown은 글이 쓰이는 곳입니다 — README, 회의 메모, 스펙, 문서. PDF는 글이 보내지는 곳입니다: .md 파일을 안 여는 고객에게, 첨부파일을 원하는 매니저에게, 프린터로. 둘 사이의 간극은 변환 한 번이고, 그걸 건너자고 pandoc과 LaTeX 배포판을 설치할 필요는 없어야 합니다.

대부분의 빠른 방법들의 함정은, 기술 문서가 의존하는 바로 그 부분들을 망가뜨린다는 것입니다: 코드 블록이 가변폭 활자로 무너지고, 파이프 표가 | 문자의 벽으로 인쇄되고, 중첩 목록이 평평해집니다. 여기서 변환기가 쓸모 있으려면 코드와 표가 살아남아야 합니다 — 이 가이드가 모든 것에 들이대는 기준이 바로 그것입니다.

변환하는 방법 — 단계별

🔒 pdfty.com/en/tools/markdown-to-pdf

정확히 무엇이 렌더링되나

변환기는 표준 Markdown에 기술 문서에 중요한 확장을 더해 지원합니다:

• 제목 — 크기 위계, H1·H2 아래의 은은한 구분선
• 펜스 코드 블록 — 고정폭, 옅은 회색 배경, 들여쓰기 보존, 흔한 언어들의 구문 강조
• 인라인 코드 — 익숙한 회색 칩 스타일
• 표 — GitHub식 파이프 표가 음영 헤더 행이 있는 테두리 표로
• 인용구 — 왼쪽 테두리, 차분한 텍스트
• 목록 — 순서 있는 것, 없는 것, 중첩
• 링크 — PDF에서도 클릭 가능한 링크로 유지
• URL 이미지 — ![](https://…) 이미지는 가져와 임베드됩니다

페이지는 넉넉한 여백의 편안한 읽기 폭으로 조판됩니다 — 날것의 브라우저 출력물보다는 "완성되어 보이는 내부 문서"에 가깝습니다.

렌더링되지 않는 것

솔직함 코너입니다. Markdown에는 방언이 있고, 이 도구는 표준 Markdown + 표 + 펜스 코드를 구현하지, GitHub 플레이버 전체를 구현하지 않습니다:

• 작업 목록(- [ ] todo)은 체크박스가 아니라 괄호 그대로 인쇄됩니다.
• 취소선(~~text~~)은 변환되지 않습니다 — 물결표가 남습니다.
• 로컬 이미지(![](./diagrams/arch.png))는 나타날 수 없습니다: 파일 하나만 업로드하므로 서버는 디스크에서 그 옆에 있던 파일에 접근할 수 없습니다. 이미지를 URL로 호스팅하거나 빈 자리를 각오하세요.
• Mermaid / 수식 블록은 다이어그램이나 수식이 아니라 일반 코드 블록으로 렌더링됩니다.
• 커스텀 테마 없음 — 내장 스타일시트 하나, CSS 업로드 없음.

무료 로컬 대안

pandoc — 정석 변환기: pandoc README.md -o readme.pdf. 출력이 탁월하고 무한히 조정되지만, PDF 출력에는 LaTeX 엔진이 필요합니다(흔히 1–4 GB 설치). 매주 문서를 변환한다면 가치가 있고, README 하나에는 터무니없습니다.

VS Code 확장(예: "Markdown PDF") — 이미 VS Code에 산다면 편리합니다; 출력 품질은 확장과 테마에 따라 다릅니다.

브라우저 미리보기 + 인쇄: Markdown을 미리보기되는 곳 어디서든 렌더링하고(많은 에디터가 HTML 미리보기를 제공합니다) Ctrl/Cmd+P → PDF로 저장. 무료에 로컬이지만 브라우저 인쇄의 기벽을 물려받습니다: 끄지 않으면 붙는 URL 머리글·바닥글, 코드 블록 한가운데 떨어지는 페이지 나눔.

macOS: 내장 Markdown 렌더러가 없습니다 — 미리보기와 텍스트 편집기는 .md 를 일반 텍스트로 취급해서 날것의 해시와 별표를 보게 됩니다.

실전에서 걸리는 것들

• 페이지 나눔은 자동입니다. 긴 코드 블록이 페이지에 걸쳐 쪼개질 수 있습니다. 수동 페이지 나눔 마커는 없고, 엔진이 필요한 곳에서 나눕니다.
• 아주 넓은 표와 긴 코드 줄은 콘텐츠 폭에서 축소되거나 잘립니다 — 200자짜리 표 행은 세로 페이지에 우아하게 들어갈 수 없습니다. 가능하면 줄을 줄이세요.
• 프런트매터(파일 맨 위의 --- YAML)는 숨겨지지 않고 내용으로 취급됩니다 — 인쇄되는 걸 원치 않으면 변환 전에 지우세요. (맨 위의 --- 블록은 형식에 따라 수평선 더하기 텍스트로 렌더링될 수도 있습니다.)
• :rocket: 같은 이모지 숏코드는 그대로 남습니다; 실제로 붙여넣은 이모지 문자는 대체로 렌더링됩니다.
• 링크 대상을 확인하세요. 상대 링크([docs](./docs/setup.md))는 링크로 살아남지만 인쇄된 뒤에는 쓸모 있는 곳을 가리키지 않습니다.

PDF가 생기면 평소의 도구함이 적용됩니다: 페이지 카운터는 머리말·꼬리말 로 찍고, 챕터들은 병합 으로 합치고, 이미지가 많아 무거우면 압축 으로 줄이세요.

자주 묻는 질문

코드 블록의 구문 강조가 유지되나요?

네 — 언어 힌트가 있는 펜스 블록(```python)은 컬러 강조를 받고, 힌트가 없으면 회색 바탕의 일반 고정폭입니다. 어느 쪽이든 들여쓰기는 정확히 보존됩니다.

표가 정말 표로 렌더링되나요?

네 — 파이프 표(GitHub 스타일)가 음영 헤더 행이 있는 테두리 표가 됩니다. 정렬 콜론도 파서가 존중합니다.

PDF에서 내 이미지가 왜 빠졌나요?

로컬 경로로 참조되었기 때문입니다. 업로드는 .md 파일 하나라서 ./images/x.png 는 아무것도 가리키지 않습니다. 완전한 https:// URL을 쓰거나, 상대 경로가 해석되는 pandoc으로 로컬에서 변환하세요.

GitHub에서 README를 바로 변환할 수 있나요?

먼저 raw .md 파일을 내려받은 뒤 업로드하세요. 완전한 URL로 호스팅된 배지와 이미지는 대개 넘어옵니다; GitHub 전용 기능(작업 목록, mermaid)은 안 됩니다 — 위 목록을 보세요.

글꼴·여백·색상을 바꿀 수 있나요?

이 도구에서는 안 됩니다 — 의도적으로 깔끔한 스타일시트 하나로 출고됩니다. 브랜드 디자인이 필요하면 자기 CSS와 함께 HTML → PDF 를 거치세요.

크기나 페이지 제한이 있나요?

무료: 파일당 20 MB, 하루 10회 — 텍스트 파일에는 사실상 무제한입니다. 단일 Markdown 원본에서 50페이지 넘는 PDF도 잘 생성됩니다.

내 문서는 비공개로 유지되나요?

전송은 HTTPS이고 파일은 1시간 이내에 자동 삭제됩니다. 업로드할 수 없는 기밀 자료라면 pandoc이 로컬 루트입니다.

반대로 PDF를 Markdown으로 바꿀 수 있나요?

직접적으로는 안 됩니다. 가장 가까운 건 텍스트 추출(서식 없는 일반 텍스트)이거나 PDF → Word 후 거기서 정리하는 것입니다.