Markdown을 PDF로 만들기
Markdown을 PDF로는 CommonMark .md 파일을 WeasyPrint로 PDF로 렌더하며, 중국어·일본어·한국어를 아우르는 글꼴 스택을 씁니다. 파일은 UTF-8이어야 합니다.
여기에 파일을 끌어다 놓거나, 클릭해 고릅니다
MD 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일
Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.
Markdown을 PDF로는 `pulldown_cmark`로 CommonMark를 파싱해 HTML(Noto Sans CJK 글꼴 스택 포함)로 감싼 뒤 그 HTML을 WeasyPrint로 인쇄합니다. `.md` 파일을 올립니다. API는 Markdown과 리소스가 든 ZIP도 받지만, 웹사이트 파일 선택기는 `.md`만 나열합니다.
Pandoc 복제품도, 슬라이드 엔진도 아닙니다. 표, 취소선, 작업 목록은 렌더됩니다. 각주나 이모지 단축 코드 같은 그 밖의 GitHub 전용 확장은 변환되지 않습니다. 페이지는 A4에 여백 2cm입니다. 펜스로 감싼 HTML 안의 JavaScript는 실행되지 않습니다.
`.md` / `.zip`이 아닌 이름은 거절됩니다. Markdown 경로는 UTF-8이 필요합니다. 암호화된 PDF는 잘못된 입력입니다. Markdown에서 시작하세요.
이미 HTML이 있으면 HTML을 PDF로가 CommonMark 단계를 건너뜁니다. PDF가 있고 Markdown을 얻고 싶다면 반대 방향인 PDF를 Markdown으로를 쓰세요.
내장 스타일시트는 본문 11pt, 줄 높이 1.6, 짙은 회색(`#111`) 텍스트, 약간 더 옅은(`#444`) 제목, 페이지 너비로 제한되는 이미지를 설정합니다. 래퍼는 텍스트를 보고 문서 언어를 영어, 중국어 간체 또는 번체, 일본어, 한국어, 아랍어, 태국어, 힌디어 중 하나로 설정하며, 아랍어 텍스트는 오른쪽에서 왼쪽으로 배치됩니다.
ZIP의 경우 변환기는 Markdown 파일 하나만 렌더합니다. 아카이브 루트에 `index.md`가 있으면 그것을, 없으면 폴더를 훑으며 처음 찾은 `.md`를 씁니다. 생성된 HTML은 압축을 푼 폴더의 루트에 저장되므로, Markdown 안의 이미지 경로는 `.md`가 있는 하위 폴더가 아니라 그 루트를 기준으로 해석됩니다.
출력은 업로드한 파일 이름을 따르므로 `release-notes.md`는 `release-notes.pdf`를 반환합니다.
기능
- CommonMark(`pulldown_cmark`) 후 WeasyPrint
- CJK 대응 HTML 래퍼. Pandoc 아님
- 웹사이트는 `.md`를 받고 API는 ZIP도 허용
- 익명 API: /api/v1/convert/markdown/pdf
이런 경우에
- README나 스펙을 PDF로 인쇄
- OCR Markdown을 인쇄 가능한 PDF로 만듦
- CommonMark 노트를 쪽이 나뉜 파일로 공유
- 작업 목록과 표가 있는 회의록을 고정된 문서로 보관
- CJK나 아랍어 노트를 Markdown 도구를 쓰지 않는 사람에게 전달
Markdown을 PDF로 변환하려면?
- UTF-8 `.md` 파일을 업로드합니다.
- 처리를 누릅니다. 이 페이지에는 테마나 용지 필드가 없습니다.
- PDF를 내려받습니다.
- 제목, 목록, CJK 글리프를 확인합니다. 복잡한 HTML 임베드는 인쇄되지 않을 수 있습니다.
- 이미지가 빠졌다면 `index.md`와 이미지 파일이 든 ZIP으로 API를 쓰고, 경로는 아카이브 루트 기준 상대 경로로 쓰세요.
- 다른 모양(용지 크기, 글꼴, 색)이 필요하면 직접 HTML로 변환해 자신의 CSS를 넣고 HTML을 PDF로를 쓰세요. 이 페이지에는 스타일 옵션이 없습니다.
제한과 경계
- Pandoc 필터 없음, JS 없음, 테마 선택 없음
- API는 ZIP을 허용하지만 웹사이트 선택기는 ZIP을 노출하지 않음
- UTF-8 Markdown이어야 함
- ZIP은 Markdown 파일 정확히 하나만 렌더함
- 페이지 크기, 여백, 글꼴은 내장 스타일시트로 고정됨
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- UTF-8 Markdown의 제목과 목록은 대개 그 스타일을 가진 짧은 PDF가 됨
- .txt를 .md로 이름만 바꿔도 확장자 검사는 통과할 수 있으나 유효한 UTF-8이 필요
- 파이프 표와 `- [x]` 작업 목록이 있는 `notes.md`는 두 확장이 모두 켜져 있으므로 표와 체크된 항목이 인쇄됨
- `[^1]`로 쓴 각주는 파서 옵션이 변환하지 않으므로 글자 그대로 나타남. 대신 인라인 주석을 쓰세요
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- Mermaid나 JS 위젯을 실행하나요?
- 아닙니다. WeasyPrint가 CommonMark로 만든 HTML을 인쇄합니다. 스크립트는 실행되지 않습니다.
- 파일이 거절된 이유는요?
- 이름이 .md 또는 .zip으로 끝나야 합니다. 다른 확장자는 지원하지 않는 파일 형식으로 거절됩니다.
- OCR로 얻은 Markdown을 여기로 보낼 수 있나요?
- 가능합니다. .md 파일이기만 하면 됩니다. 이 사이트의 OCR에서 이어서 쓸 수 있는 몇 안 되는 유용한 연결 중 하나입니다.
- GitHub Flavored Markdown을 완전히 지원하나요?
- 일부만 지원합니다. CommonMark에 더해 표, 취소선, 작업 목록이 켜져 있고, 각주와 이모지 단축 코드는 지원하지 않습니다.
- PDF의 페이지 크기와 여백은 어떻게 되나요?
- A4, 여백 2cm, 본문 11pt입니다. 고정되어 있으며 이 페이지에는 바꿀 필드가 없습니다.
- 중국어, 일본어, 한국어, 아랍어 텍스트도 되나요?
- 래퍼가 주된 문자 체계를 감지해 문서 언어를 설정하고, 글꼴 스택에는 CJK, 아랍어, 태국어, 데바나가리 계열이 올라 있습니다. 글리프가 실제로 인쇄되는지는 서버에 맞는 글꼴이 설치되어 있는지에 달려 있으므로, 출력에 빈 네모가 없는지 확인하세요.
- 이미지는 어떻게 넣나요?
- Markdown 파일과 이미지를 넣은 ZIP을 API로 보내고, 아카이브 루트 기준 상대 경로로 참조하세요. 웹 선택기는 .md 파일만 나열합니다.
- ZIP에 Markdown 파일이 여러 개이면 어느 것을 쓰나요?
- 하나만 씁니다. 루트에 index.md가 있으면 그것을, 없으면 폴더를 뒤지며 처음 찾은 .md를 씁니다. 여러 파일을 인쇄하려면 먼저 Markdown 파일 하나로 합치세요.
- 업로드가 올바른 텍스트가 아니라는 오류는 무엇인가요?
- 유효한 UTF-8이 아닌 일반 .md 업로드는 Markdown 파일이 유효한 UTF-8 텍스트가 아니라는 메시지로 거절됩니다. 파일을 UTF-8로 다시 저장한 뒤 시도하세요.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/convert/markdown/pdf" \
-F "[email protected]" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'Markdown을 PDF로' 작업을 대신 실행합니다: /skills/pdf123-markdown-to-pdf.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.