---
title: "마크다운 PDF 변환"
description: "마크다운 PDF 변환은 브라우저 인쇄 변환기입니다. Markdown을 붙여 넣고 용지 크기와 테마를 고른 뒤 인쇄 / PDF로 저장을 사용하세요. 문서는 로컬에서 인쇄되고 아무것도 업로드되지 않습니다."
url: https://markitdown.ai/markdown-to-pdf
updated: 2026-09-26
source: markitdown.ai
---

# 마크다운 PDF 변환

> 마크다운 PDF 변환은 브라우저 인쇄 변환기입니다. Markdown을 붙여 넣고 용지 크기와 테마를 고른 뒤 인쇄 / PDF로 저장을 사용하세요. 문서는 로컬에서 인쇄되고 아무것도 업로드되지 않습니다.

## Markdown을 PDF로 변환하는 방법

- 에디터에 Markdown을 붙여 넣으세요. 용지 크기(A4 또는 Letter), 여백, 방향, 테마를 고르면 미리보기가 로컬에서 갱신됩니다.
- 페이지가 나뉜 미리보기를 검토하세요. 인쇄 전에 페이지 나눔, 한 페이지를 차지하는 표, 다국어 텍스트를 확인하세요.
- 브라우저에서 인쇄 / PDF로 저장을 여세요. 로컬에서 인쇄됩니다. 아무것도 업로드되지 않으며 PDF는 우리 서버가 아니라 브라우저 인쇄 엔진이 생성합니다.

## 이 마크다운 PDF 변환을 쓰는 이유

Markdown 파일에는 자체 페이지 기하 구조가 없습니다. 이 변환기가 용지 크기, 여백, 페이지 나눔 규칙을 더한 뒤 결과를 브라우저 인쇄 엔진에 넘깁니다.

- 로컬 인쇄, 업로드 없음 — PDF는 브라우저 인쇄 엔진이 생성합니다. Markdown은 기기를 떠나지 않습니다.
- 용지 크기와 여백 — 인쇄 전에 A4 또는 Letter, 세로 또는 가로, 보통·좁은·넓은 여백을 고르세요.
- 문서별 테마 — Github, document, compact 테마가 Markdown은 그대로 두고 글꼴, 간격, 코드 블록 색을 바꿉니다.
- 페이지 번호 — 현재 테마 스타일로 인쇄되는 모든 페이지의 모서리나 가운데에 페이지 번호를 더하세요.
- CJK를 고려한 글꼴 스택 — 인쇄 스타일시트가 중국어, 일본어, 한국어 시스템 글꼴을 라틴 대체 글꼴보다 먼저 나열해 여러 문자 체계가 섞인 보고서를 지원합니다.
- API와 같은 HTML 렌더러 — 문서는 POST /v1/convert/markdown/html와 같은 안전한 HTML로 만들어지고, 브라우저가 PDF로 바꾸는 인쇄 CSS로 감싸집니다.

## 인쇄 전에 Markdown에 페이지 규칙이 필요한 이유

- Markdown에는 페이지 기하 구조가 없습니다 — Markdown 파일은 제목과 문단을 설명할 뿐 용지 크기, 여백, 페이지가 어디서 나뉠지를 설명하지 않습니다.
- 긴 표와 코드 블록이 잘못 나뉩니다 — 페이지 나눔 규칙이 없으면 표 행이나 펜스 코드 블록이 인쇄 페이지 끝에서 반토막 날 수 있습니다.
- CJK와 혼합 문자에는 올바른 글꼴이 필요합니다 — 중국어, 일본어, 한국어 텍스트는 브라우저와 운영체제에 따라 글리프 누락이나 다른 줄바꿈 동작을 겪을 수 있습니다.

## 이 마크다운 PDF 변환이 보존하는 것

- 페이지 크기와 여백 — @page 규칙이 브라우저가 인쇄 대화상자를 열기 전에 용지 크기(A4 또는 Letter), 방향, 여백을 고정합니다.
- 제목이 새 페이지를 시작할 수 있음 — 1단계 제목은 기본으로 새 페이지로 넘어가므로 각 최상위 섹션이 깔끔하게 시작합니다. 문서의 첫 제목은 그렇지 않습니다.
- 표와 코드는 페이지 중간에서 나뉘지 않음 — 표와 펜스 코드는 내부에서 나뉘지 않도록 표시되어, 브라우저가 블록을 자르는 대신 다음 페이지로 통째로 옮깁니다.
- CSS 카운터로 만드는 페이지 번호 — 선택적인 페이지 번호는 CSS 페이지 카운터로 생성되며 바닥글 왼쪽, 가운데, 오른쪽에 배치됩니다.
- API와 같은 안전한 HTML — 인쇄 가능한 문서는 POST /v1/convert/markdown/html가 쓰는 것과 같은 CommonMark·GFM 안전 HTML에서 시작합니다.

## 마크다운 PDF 변환 사용 사례

Markdown 메모가 Markdown 리더 없이도 열 수 있는 페이지가 나뉜 파일이 되어야 할 때.

- 보고서와 연구 메모 — Markdown 보고서를 페이지가 나뉜 PDF로 변환해 Markdown 리더가 없는 사람과 공유하세요.
- 다국어 문서 — CJK를 고려한 글꼴 스택으로 라틴 문자와 중국어, 일본어, 한국어 텍스트가 섞인 메모를 인쇄하세요.
- README에서 만드는 빠른 소책자 — 별도 PDF 도구를 설치하지 않고 문서나 README의 인쇄 버전을 만드세요.
- Markdown 메모 보관 — 메모가 계속 바뀌기 전에 날짜가 찍힌 페이지 나뉜 스냅샷을 어디에도 업로드하지 않고 저장하세요.

## 브라우저에서 인쇄

이 도구는 브라우저에서 인쇄 가능한 문서를 만들고 브라우저 자체의 인쇄 / PDF로 저장 대화상자에 넘깁니다. 서버 측 PDF 생성은 계획되어 있지만 아직 제공되지 않으므로 API에는 오늘날 PDF 엔드포인트가 없습니다. 오늘 자동화된 프로세스에서 PDF가 필요하면 POST /v1/convert/markdown/html로 안전한 HTML을 렌더링한 뒤 통제하는 도구로 그 HTML을 인쇄하거나, 단일 문서에는 이 페이지를 대화형으로 사용하세요. 서버 엔드포인트가 출시되면 이 섹션을 갱신합니다. 그때까지는 브라우저 인쇄 경로를 이 제품의 유일한 지원되는 마크다운 PDF 변환 경로로 여기세요.

## 용지, 여백, 테마

용지 크기와 여백은 각 페이지에서 문단, 표, 코드가 가질 공간을 정합니다. 좁은 여백은 페이지당 더 많이 들어가지만 빽빽한 표를 답답하게 만들 수 있고, 넓은 여백은 페이지가 늘어나는 대신 더 편하게 읽힙니다. 세 테마는 Markdown 자체를 건드리지 않고 글꼴, 간격, 코드 블록 배경을 바꾸므로, 압축적인 내부 메모와 외부 독자를 위한 문서를 비교할 때 테마를 바꾸는 것이 안전합니다. 변경 후에는 항상 페이지가 나뉜 미리보기를 확인하세요. 짧은 메모에서 잘 보이는 설정이 더 긴 보고서에서는 표를 페이지 나눔 너머로 밀어낼 수 있습니다.

- A4는 미국 외 사용자 대부분에게 맞고, Letter는 미국 중심 문서에 맞습니다.
- 좁은 여백은 페이지당 더 많은 내용을 넣고, 넓은 여백은 더 편하게 읽힙니다.
- 페이지 번호는 인쇄해 철한 보고서가 순서를 유지하는 데 도움이 됩니다.

## 다국어와 코드

라틴 텍스트와 중국어, 일본어, 한국어 문자가 섞인 Markdown은 실제로 인쇄하는 기기에 설치된 글꼴에 의존하므로, Markdown 원본이 같아도 두 컴퓨터에서 페이지가 다르게 나뉠 수 있습니다. 인쇄할 기기에서 미리보기를 확인하세요. 특히 글리프 누락이 제목을 엉뚱한 페이지로 밀어낼 수 있는 긴 보고서에서 중요합니다. 코드 블록과 공백 없는 긴 URL도 비슷합니다. 이들은 줄 중간에서 나뉘지 않도록 표시되어 있어, 브라우저가 복사할 수 있는 명령을 자르는 대신 블록 전체를 다음 페이지로 옮깁니다.

## 이 마크다운 PDF 변환 뒤의 인쇄 CSS

Source: markitdown.ai 인쇄 스타일시트: github 테마, A4, 페이지 번호 켜짐

```css
@page { size: A4 portrait; margin: 25mm; }
@page { @bottom-center { content: counter(page); font-size: 10pt; color: var(--md-muted); } }
h1 { break-before: page; }
article.md-document > h1:first-child { break-before: auto; }
table, pre { break-inside: avoid; }
```

## FAQ

### 마크다운 PDF 변환은 내 텍스트를 업로드하나요?

아니요. 로컬에서 인쇄합니다. PDF를 만들기 위해 업로드되는 것은 없으며, 전적으로 브라우저 인쇄 엔진이 생성합니다.

### 서버 측 마크다운 PDF 변환 API가 있나요?

아직 없습니다. POST /v1/convert/markdown/pdf가 없으므로 호출하면 404를 반환합니다. POST /v1/convert/markdown/html로 HTML을 렌더링해 인쇄하거나, 이 페이지의 브라우저 도구를 사용하세요.

### A4 또는 Letter를 고를 수 있나요?

네. 용지 크기, 방향, 여백, 페이지 번호는 에디터의 로컬 옵션입니다.

### 중국어, 일본어, 한국어 텍스트를 처리하나요?

인쇄 스타일시트가 라틴 대체 글꼴보다 CJK 시스템 글꼴을 먼저 나열합니다. 글꼴 가용성은 기기마다 다르므로 인쇄 전에 페이지가 나뉜 미리보기를 확인하세요.

### 제목이 항상 새 페이지를 시작하나요?

기본으로 문서의 첫 제목을 제외한 1단계 제목이 새 페이지로 넘어가며, 이는 끌 수 있습니다.

### 마크다운 PDF 변환에 계정이 필요한가요?

아니요. 붙여 넣기, 미리보기, 인쇄가 로그인 없이 동작합니다.

### 나중에 서버 생성 PDF 파일이 생기나요?

서버 측 PDF 생성은 계획되어 있습니다. 오늘 이 페이지는 브라우저 인쇄 대화상자를 사용하며 서버 측 PDF 엔드포인트가 없습니다.

## Related

- [Markdown to HTML Converter](https://markitdown.ai/markdown-to-html)
- [Markdown to Text Converter](https://markitdown.ai/markdown-to-text)
- [PDF to Markdown Converter](https://markitdown.ai/pdf-to-markdown)