PDF에 페이지 번호 넣기: 위치, 시작 번호, 그리고 회전된 페이지의 함정

페이지 번호 넣기는 PDF의 모든 페이지에 일반 10진수 번호를 씁니다. 모서리, 글자 크기, 첫 번호는 고를 수 있고 나머지는 고정입니다. 회전된 상태로 저장된 페이지, 비워 둬야 하는 표지, 페이지에 이미 인쇄된 번호는 이 도구가 알지 못하며, 그 각각은 업로드하기 전에 직접 판단해야 합니다.

도구가 쓰는 것

각 번호는 페이지 콘텐츠에 추가되는 검은색 Helvetica 텍스트이므로, 어떤 뷰어에서든 인쇄되고 파일과 함께 이동합니다. 글꼴이나 색상 옵션은 없습니다. 일부 리더가 썸네일 창에 보여 주는 페이지 라벨 설정과는 다릅니다. "iii"나 "A-1" 라벨을 표시하는 뷰어는 계속 자기 라벨을 보여 줍니다.

폼에서 쓸 수 있는 설정은 세 가지입니다.

• 위치: 왼쪽 위, 가운데 위, 오른쪽 위, 왼쪽 아래, 가운데 아래, 오른쪽 아래. 폼의 기본값은 가운데 아래입니다. API에서는 값 1, 2, 3, 7, 8, 9에 해당하고, 4, 5, 6은 세로 중앙의 왼쪽, 가운데, 오른쪽에 번호를 놓습니다.
• 시작 번호: 기본값 1. 첫 페이지가 이 값을 받고 이후 페이지마다 1씩 늘어납니다.
• 글자 크기: 기본값 12, 폼에서는 6에서 200까지. API는 이 범위를 강제하지 않으니 범위 안에서 쓰세요.

시작 번호는 정수여야 합니다. abc는 400 invalid_parameter로 거부되고, 음수는 받아들여 그대로 그려집니다(-2, -1, 0, 1, ...).

번호의 기준점은 페이지 가장자리에서 48포인트(3분의 2인치) 안쪽이며, 페이지의 MediaBox 크기로 계산합니다. 숫자는 기준점에서 오른쪽으로 쓰이므로, "가운데 아래"는 숫자의 왼쪽 끝을 중심선에 놓고 세 자리 번호는 중앙보다 약간 오른쪽에서 끝납니다. "오른쪽 아래"는 오른쪽 가장자리에서 48포인트 지점에서 시작해 가장자리 쪽으로 이어지므로, 12 pt 세 자리 번호는 가장자리에서 대략 28포인트 지점에서 끝납니다. 12 pt에서는 이 차이가 눈에 잘 띄지 않습니다.

실제 예: 계약서 2권

100페이지짜리 1권에 이어지는 6페이지 파일 contract.pdf가 있다고 합시다. 페이지 번호 넣기에 올리고 시작 번호를 101, 위치를 오른쪽 아래, 크기를 12로 설정하세요. 2026-10-04에 로컬 빌드로 실행했을 때 출력은 6페이지 PDF였고, 텍스트를 추출하자 101부터 106까지의 번호가 페이지마다 본문 아래 오른쪽 아래에 하나씩 있었습니다. 뷰어에 따라 렌더링의 세부는 다를 수 있지만 순서와 값은 같습니다.

이 결과에서 알아 둘 것이 둘 있습니다. 출력은 입력의 이름(contract.pdf)을 그대로 유지하므로 원본을 덮어쓰기 전에 이름을 바꾸세요. 그리고 position 없이 보낸 API 요청은 폼의 가운데 아래가 아니라 오른쪽 위(값 3)에 번호를 놓았습니다. 스크립트에서는 position을 명시해서 보내세요.

묶음 문서의 작업 순서

이 도구는 받은 파일의 모든 페이지에 번호를 매깁니다. 표지를 건너뛰거나 중간에서 다시 시작할 수 없습니다. 그래서 작업 순서가 결과를 정합니다.

페이지에 이미 인쇄된 번호가 있으면 새 번호는 그 위에 추가로 그려집니다. 같은 파일에 도구를 두 번 돌리면 페이지마다 번호가 두 개가 됩니다. 테스트에서 같은 위치로 두 번째 실행을 하자 새 "1"이 기존 "101" 위에 그려져 둘이 겹쳤습니다. 번호 없는 원본을 보관하고 항상 그 파일에서 시작하세요.

표지나 구간을 깔끔하게 잘라 내는 방법, 그리고 삭제한 페이지가 무엇을 남길 수 있는지는 PDF의 일부 페이지만 보내기에서 다룹니다.

회전된 페이지의 함정

스캐너와 휴대폰에서 나온 페이지는 다시 그리지 않고 회전 플래그를 둔 채 저장되는 경우가 많습니다. 번호는 회전되지 않은 페이지를 기준으로 놓이므로, 90도 회전된 것으로 저장된 페이지에서는 엉뚱한 가장자리에 옆으로 누워서 놓입니다. 테스트에서 90도 회전 플래그가 붙은 Letter 페이지에 "가운데 아래"로 번호를 매기자, 가로 페이지가 표시되었고 작은 "1"이 아래쪽 가장자리가 아니라 왼쪽 가장자리의 중간쯤에 옆으로 누워 있었습니다.

순서를 직접 정할 수 있다면 먼저 번호를 매기고 나중에 PDF 회전으로 돌리세요. 회전은 페이지 전체에 적용되므로 번호도 텍스트와 함께 돌아갑니다. 파일이 이미 회전 플래그가 붙은 채 도착한다면 이 도구는 보정할 수 없고 바로잡는 설정도 없습니다. 번호를 매긴 뒤 그런 페이지를 뷰어에서 확인하세요.

인쇄하기 전에 확인하세요

첫 페이지, 중간 페이지, 마지막 페이지를 열어 보세요. 펀치 구멍 여백, 사진, 이미 텍스트가 들어 있는 바닥글 위에 숫자가 놓여 있지 않은지 살펴보세요. 파일 끝에 빈 페이지가 있다면 먼저 페이지 삭제를 하고 그다음에 번호를 매겨야 마지막 번호가 마지막 실제 페이지와 맞습니다. 번호는 이제 페이지의 일부이므로, 이후에 페이지 추출이나 순서 변경을 하면 번호는 원래 페이지에 붙은 채 남아 연번이 더는 순서대로 이어지지 않습니다. 순서가 바뀌면 번호 없는 파일에서 다시 번호를 매기세요.

변경할 권한이 있는 문서에만 번호를 매기고, 제출 절차가 표시 없는 원본을 요구한다면 번호 없는 원본을 보관하세요. 비밀번호로 보호된 파일은 비밀번호가 필요합니다. 브라우저 페이지는 비밀번호를 묻고, 비밀번호 없이 API를 호출하면 400 password_required("This PDF is password-protected. Enter its password.")를 받으므로 먼저 파일의 비밀번호를 해제하세요. 도구를 호출하는 데 API 키는 필요 없습니다.