PDF 페이지에 텍스트 워터마크 추가하는 방법

Q: 워터마크 문구를 생략해도 되나요?

문구를 입력하지 않은 경우에는 기본값인 CONFIDENTIAL 이 사용됩니다. 직접 작성하는 문구는 1자 이상 200자 이하이어야 하므로, 길이를 확인한 뒤 처리하세요. 결과 PDF에서 실제 표시 내용도 살펴보면 됩니다.

Q: PDF를 넣었는데 처리되지 않으면 무엇을 확인해야 하나요?

먼저 문구가 비어 있거나 200자를 넘지 않는지 확인하세요. 이어서 디코딩한 PDF 데이터의 시작이 %PDF- 인지 점검해야 합니다. 조건을 충족해도 유효하지 않은 PDF나 인식된 처리 오류가 있으면 성공하지 않은 결과가 나올 수 있습니다.

PDF를 올바른 base64 입력으로 준비하고 문구와 불투명도를 지정하면 모든 페이지에 회색 텍스트 워터마크를 추가할 수 있습니다. 문구를 비워 두면 CONFIDENTIAL이 기본값으로 사용됩니다.

페이지 전체에 표시할 내용 고르기

PDF의 모든 페이지에 같은 문구를 표시해 문서의 상태나 취급 주의를 나타내고 싶을 때 사용할 수 있습니다. 기본 문구를 그대로 쓰거나 원하는 텍스트로 바꿀 수 있으며, 표시 농도도 숫자로 조정할 수 있습니다. 워터마크는 회색 글씨로 페이지의 세로 중간 부근에 놓이고, 기존 페이지 내용 위에 추가됩니다.

따라서 표지 한 장에만 표시하는 기능이 아니라 여러 페이지에 동일한 안내를 남기는 용도에 맞습니다. 입력을 준비할 때는 PDF 데이터의 형식과 워터마크 문구의 길이를 먼저 살펴보세요. 결과를 받은 뒤에는 페이지마다 문구가 보이는지, 본문이나 표와 겹쳐 읽기 어려운 부분은 없는지 확인하는 것이 좋습니다. 불투명도에 따라 글자의 농도가 달라지므로 문서의 배경과 함께 결과를 판단해야 합니다.

처리 대상은 PDF이며, 파일 값은 base64로 제공해야 합니다. 디코딩한 값의 시작 부분이 %PDF-인지 확인하면 PDF 입력 조건을 점검할 수 있습니다. PDF가 아닌 데이터를 사용하거나 형식이 올바르지 않으면 원하는 결과가 나오지 않을 수 있습니다. 페이지별로 서로 다른 문구를 지정하는 기능으로 이해하지 말고, 지정한 하나의 문구가 각 페이지에 반복된다고 보세요.

입력값을 정하고 PDF 처리하기

워터마크를 넣을 PDF를 준비합니다. PDF의 값을 base64 형식으로 만들고, 그 값을 디코딩했을 때 처음 바이트가 %PDF-로 시작하는지 확인하세요. 파일 이름만 전달한 값이나 PDF가 아닌 데이터를 인코딩한 값은 입력 조건을 충족하지 못할 수 있습니다.
표시할 문구를 정합니다. 직접 입력하는 경우에는 1자 이상 200자 이하로 작성하세요. 여러 페이지에서 읽을 문구인 만큼 핵심 내용을 짧게 정하면 결과를 확인하기 쉽습니다.
불투명도를 숫자로 지정합니다. 값을 생략하면 기본값은 0.3이며, 사용할 수 있는 범위는 0.05부터 1.0까지입니다. 퍼센트 기호가 아닌 숫자를 입력하고, 필요한 농도에 맞춰 범위 안에서 선택하세요.
PDF, 워터마크 문구, 불투명도 값을 함께 제출해 처리합니다. 문구를 생략했다면 기본 문구가 적용되므로 결과에서 실제 표시 내용을 확인하세요.
결과 상태가 성공인지 확인한 다음 결과 PDF를 엽니다. 여러 페이지에 문구가 모두 들어갔는지, 회색 글씨가 세로 중간 부근에 놓였는지, 원래 내용 위에 표시되는지를 차례로 살펴보세요. 중요한 표나 본문을 가리는 부분이 있다면 불투명도를 조정해 다시 처리할 수 있습니다.

완료된 PDF에서 확인할 항목

성공한 결과는 지정한 문구가 PDF의 각 페이지에 추가된 형태입니다. 워터마크는 회색 텍스트로 세로 중간 부근에 표시되고 기존 페이지 내용 위에 놓이므로, 결과 PDF를 직접 열어 실제 위치와 겹침 상태를 확인해야 합니다. 문구가 모든 페이지에 같은 방식으로 나타나는지도 함께 살펴보세요.

불투명도는 백분율이 아니라 숫자로 해석됩니다. 0.05에 가까운 값은 상대적으로 옅은 표시를, 1.0에 가까운 값은 상대적으로 진한 표시를 선택하는 기준이 됩니다. 기본값 0.3으로 먼저 확인한 뒤 배경과 본문을 고려해 허용 범위 안에서 바꾸면 됩니다. 이 수치는 워터마크의 농도를 조정하는 설정이며, 위치나 색상을 바꾸는 설정은 아닙니다.

문구가 비어 있거나 200자를 초과하면 PDF 처리 전에 거부됩니다. PDF 데이터가 유효하지 않거나 PDF 처리 과정에서 오류가 인식되어도 성공하지 않은 결과가 반환될 수 있습니다. 문제가 생기면 문구 길이, 불투명도 숫자, 디코딩한 데이터의 %PDF- 시작 여부를 순서대로 점검하세요. 입력 조건을 확인한 뒤에도 실패한다면 결과 상태를 다시 살펴보고 원본 PDF 데이터가 실제 PDF인지 확인하세요. 워터마크는 각 페이지에 같은 문구를 더하는 방식이므로 페이지마다 다른 텍스트가 필요한 작업에는 맞지 않습니다.

사용 예시

외부에 공유할 거래명세서 PDF의 각 페이지에 기밀 표시를 넣으려 합니다.

거래처에 보낼 여러 페이지 PDF의 문구를 CONFIDENTIAL로 정하고 불투명도를 0.3으로 지정해 처리한 뒤, 결과 PDF에서 페이지마다 같은 문구가 나타나는지 확인합니다.

성공한 결과 PDF의 각 페이지에 회색 CONFIDENTIAL 문구가 세로 중간 부근에서 기존 내용 위에 보입니다.

제한 사항

입력값은 디코딩했을 때 %PDF-로 시작하는 PDF여야 하며, 워터마크는 회색 텍스트로 각 페이지의 세로 중간 부근에 기존 내용 위에 표시됩니다. 문구 오류나 유효하지 않은 PDF, PDF 처리 오류가 있으면 성공하지 않은 결과가 반환될 수 있습니다.

자주 발생하는 오류

디코딩한 값이 %PDF-로 시작하지 않으면 PDF로 인정되지 않아 처리 결과가 실패할 수 있습니다. 원본 PDF를 다시 base64로 인코딩한 뒤 디코딩 결과의 시작 부분을 확인하고 재제출하세요.

자주 묻는 질문

워터마크 문구를 생략해도 되나요?

문구를 입력하지 않은 경우에는 기본값인 CONFIDENTIAL이 사용됩니다. 직접 작성하는 문구는 1자 이상 200자 이하이어야 하므로, 길이를 확인한 뒤 처리하세요. 결과 PDF에서 실제 표시 내용도 살펴보면 됩니다.

워터마크의 불투명도를 조정할 수 있나요?

불투명도는 조정할 수 있습니다. 기본값은 0.3이고 입력 범위는 0.05부터 1.0까지이므로, 백분율 대신 숫자로 지정한 뒤 결과 PDF에서 글자의 농도를 확인하세요. 범위를 벗어난 값은 사용하지 않는 편이 좋습니다.

PDF를 넣었는데 처리되지 않으면 무엇을 확인해야 하나요?

먼저 문구가 비어 있거나 200자를 넘지 않는지 확인하세요. 이어서 디코딩한 PDF 데이터의 시작이 %PDF-인지 점검해야 합니다. 조건을 충족해도 유효하지 않은 PDF나 인식된 처리 오류가 있으면 성공하지 않은 결과가 나올 수 있습니다.