PDF에서 특정 문구를 찾아 가리는 방법

유효한 PDF와 검색 문구를 입력하면 페이지 텍스트에서 맞는 영역을 찾아 가릴 수 있습니다. 성공 결과에는 처리된 PDF와 처리 페이지 수, 일치 횟수가 포함되어 민감 정보가 정상적으로 마스킹되었는지 확인할 수 있습니다.

검색 대상과 입력 형식 살펴보기

이 도구는 입력한 PDF의 각 페이지에서 지정한 문구를 검색하고, 일치한 영역에 가리기 처리를 적용합니다. 계약서, 신청서, 보고서처럼 문서 안에 검색 가능한 텍스트로 들어 있는 이름이나 연락처를 대상으로 삼을 때 적합합니다. 처리 대상은 일반적인 파일 형식이 아니라 유효한 PDF이며, 입력 내용은 base64로 인코딩된 PDF 형태여야 합니다. 따라서 작업을 시작하기 전에 원본이 실제 PDF인지, 디코딩한 데이터가 PDF 서명으로 시작하는지 확인하는 편이 좋습니다. 이미지에만 표시된 글자는 검색 가능한 페이지 텍스트가 아니므로 같은 방식으로 찾을 수 없습니다. 스캔 문서처럼 글자가 그림의 일부로만 존재하는 경우에는 이 도구의 검색 범위와 맞지 않습니다. 검색할 문구의 띄어쓰기와 기호도 문서에 표시된 형태를 기준으로 준비해야 일치 여부를 판단하기 쉽습니다. 여러 문구를 처리하려면 한 번에 사용할 검색 텍스트의 범위를 먼저 정하고, 결과의 일치 횟수를 기준으로 기대한 대상이 포함되었는지 살펴보세요. 이 과정은 문서 전체를 막연히 가리는 것이 아니라 지정한 텍스트와 맞는 영역을 찾아 처리하는 방식입니다. 민감한 내용을 다룰 때는 가리려는 표현을 입력하기 전에 문서의 검색 기능으로 해당 표현이 텍스트로 선택되는지도 점검하면 좋습니다.

문구를 지정해 PDF 처리하기

처리할 문서를 준비합니다. 파일 입력에는 base64로 인코딩한 PDF를 사용하고, 디코딩한 데이터가 PDF 서명으로 시작하는지 확인합니다. 파일이 없거나 내용이 PDF로 해석되지 않으면 처리가 진행되지 않습니다.
파일 입력에 준비한 값을 넣고 검색 텍스트에 가릴 문구를 입력합니다. 검색 텍스트는 비워 둘 수 없으므로 이름, 문서 번호, 전화번호처럼 실제 페이지 텍스트에 포함된 문자열을 입력해야 합니다. 예를 들어 문서에 홍길동이 그대로 적혀 있다면 검색 텍스트에도 그 표현을 넣습니다.
필요한 경우 대체 텍스트를 정합니다. 별도 값을 지정하지 않으면 기본 가림 표시가 사용됩니다. 직접 입력하는 대체 텍스트는 ASCII 문자로 구성하고, 한글이나 다른 비ASCII 문자를 넣었을 때 해당 문자가 PDF의 대체 표시로 그대로 들어간다고 가정하지 않습니다.
처리를 실행합니다. 도구는 PDF의 페이지 텍스트를 차례로 검색한 뒤 검색 문구와 맞는 영역에 가리기 처리를 적용합니다. 검색 대상 문구가 이미지 안에만 있으면 이 단계에서 일치 항목으로 잡히지 않습니다.
성공 결과에 포함된 base64 PDF를 확인합니다. 결과를 사용하려면 반환된 값을 PDF 데이터로 디코딩하고, 처리 페이지 수와 일치 횟수도 함께 기록해 예상한 범위와 비교합니다. 입력 문구를 바꿔 다시 처리할 때는 이전 결과가 아니라 확인하려는 PDF와 검색 표현을 기준으로 새 값을 준비합니다. 결과 수치가 예상과 다르면 문서의 텍스트 선택 가능 여부와 검색 문구의 철자, 공백, 기호를 다시 대조한 뒤 재시도합니다.

성공 결과의 의미와 확인 범위

성공한 결과에는 가리기 처리가 적용된 PDF가 base64 형식으로 들어 있으며, 처리한 페이지 수와 검색 문구가 발견된 횟수도 함께 확인할 수 있습니다. 페이지 수는 작업에 포함된 문서 범위를 살피는 기준이고, 일치 횟수는 입력한 표현이 몇 번 대상이 되었는지 점검하는 기준입니다. 두 수치가 예상과 다르면 결과를 곧바로 정상 범위로 해석하기보다 원본에서 문구를 검색하거나 선택할 수 있는지 확인하세요. 일치 횟수가 0인 경우에는 입력한 철자, 띄어쓰기, 줄바꿈에 따른 표현 차이, 문서에 실제로 저장된 텍스트를 비교할 필요가 있습니다. 이미지에만 있는 내용은 페이지에 보이더라도 검색 결과에 포함되지 않으므로, 화면에 보이는 글자와 검색 가능한 글자가 다를 수 있습니다. 파일 입력이 누락되었거나 base64 디코딩 결과가 PDF 서명으로 시작하지 않으면 유효한 처리 결과가 아니라 실패로 보아야 합니다. 결과 PDF에서 매칭된 내용은 적용된 가리기 처리에 따라 제거된 형태로 제공되며, 확인된 샘플에서는 추출 텍스트와 결과 PDF 바이트에서 해당 문구가 사라진 상태가 검증되었습니다. 다만 한글처럼 ASCII가 아닌 대체값은 PDF의 주석 대체 텍스트로 그대로 삽입된다고 볼 수 없으므로, 표시 방식을 정할 때는 ASCII 입력을 사용하고 결과를 직접 확인하세요. 처리 수치와 결과 파일의 상태를 함께 살피면 문서 범위와 검색 조건을 분리해 점검할 수 있습니다.

사용 예시

계약서 PDF의 검색 가능한 본문에 있는 홍길동이라는 이름을 가리려고 합니다.

PDF의 검색 기능으로 문구가 선택되는지 확인한 뒤, 파일 입력에 PDF를 제공하고 검색 텍스트에 홍길동을 입력해 처리합니다.

성공 결과에는 가리기 처리가 적용된 base64 PDF, 처리한 페이지 수, 일치한 문구의 횟수가 포함되는 형태입니다.

제한 사항

검색 가능한 PDF 페이지 텍스트만 대상으로 하며 이미지 전용 글자는 포함하지 않습니다. 입력은 PDF 서명으로 확인되는 유효한 base64 데이터여야 하고, 비ASCII 대체값은 입력한 형태 그대로 삽입된다고 볼 수 없습니다.

자주 발생하는 오류

검색 텍스트를 비워 두거나 이미지에만 있는 글자를 입력하면 기대한 일치 항목이 나오지 않습니다. 비어 있지 않은 문구를 입력하고 PDF에서 해당 표현을 검색하거나 선택할 수 있는지 먼저 확인하세요.

자주 묻는 질문

검색 텍스트를 입력하지 않아도 되나요?

검색 텍스트가 빈 값이면 PDF 처리 전에 실패합니다. 가리려는 표현을 하나 이상 입력하고, 그 문구가 페이지에서 검색 가능한 텍스트인지 확인하세요. 문구가 이미지에만 있다면 입력해도 일치 대상으로 잡히지 않습니다.

스캔한 이미지 속 글자도 가릴 수 있나요?

스캔 이미지 안에만 있는 글자는 이 도구의 검색 대상이 아닙니다. 페이지에서 문자를 선택하거나 검색할 수 있는 텍스트가 있어야 하며, 화면에 보인다는 사실만으로 처리된다고 판단할 수 없습니다. OCR이 필요한 이미지 내용은 지원 범위 밖입니다.

가린 부분에 원하는 문자를 넣을 수 있나요?

별도 대체 텍스트를 지정하지 않으면 기본 가림 표시가 사용됩니다. 다른 값을 입력하려면 ASCII 문자로 작성하세요. 비ASCII 값은 PDF에 입력한 모양 그대로 대체 표시로 들어간다고 볼 수 없으므로, 성공 결과를 확인하는 절차가 필요합니다.