PDF 메타데이터 편집기

PDF의 표준 문서 정보 사전(제목, 작성자, 주제, 키워드, 생성기, 생산자)을 읽고 다시 씁니다. PDF의 콘텐츠는 그대로 유지되고 메타데이터 블록만 업데이트돼요. 출력은 새 값이 적용된 새 PDF이며, 원본 파일은 변경되지 않습니다.

자주 만나는 함정

PDF 메타데이터에는 값을 바꾸기 전에 알아두면 좋은 몇 가지 특이점이 있어요.

• 암호화된 PDF. 비밀번호로 보호된 PDF는 비밀번호 없이 열 수 없어요. 소유자 비밀번호가 있다면 먼저 /pdf-unlock 으로 처리하세요.
• XMP 메타데이터. 최신 PDF는 표준 필드 옆에 XMP 메타데이터 스트림을 함께 가지기도 해요. 이 도구는 표준 필드만 편집하며, XMP 전용 필드(커스텀 태그, 변경 이력, 등급)는 지원하지 않아요.
• 여러 키워드. 일부 PDF 리더는 키워드를 콤마/세미콜론으로 구분된 단일 문자열로, 다른 리더는 배열로 기대해요. 키워드 필드는 단일 문자열을 받으므로 다운스트림 도구의 기대에 맞춰 입력하세요.
• 빈 값 vs 누락. 필드를 비우면 빈 값으로 저장돼요. 일부 PDF 리더는 이를 "완전 누락"과 다르게 표시할 수 있어요. 필드를 진짜로 제거하려면 키 자체를 쓰지 않는 도구가 필요한데, pdf-lib는 그 구분을 노출하지 않습니다.
• CreationDate / ModDate. 이 타임스탬프는 여기서 편집할 수 없어요. 입력 PDF의 값을 그대로 보존하며, pdf-lib는 명시적으로 지정하지 않으면 저장 시 ModDate를 갱신하지 않아요.
• 생산자(Producer) 덮어쓰기. 많은 PDF 생성기가 자기 이름을 Producer 필드에 적어요. 표면적으로 덮어써도 되지만, 일부 컴플라이언스 워크플로우는 이 필드를 추적하니 규제 문서에서는 변경 전에 확인하세요.

PDF 콘텐츠도 바뀌나요?

아니요. 메타데이터 사전만 갱신돼요. 페이지 콘텐츠 스트림, 폰트, 이미지는 그대로 유지되며 출력 PDF는 입력과 동일하게 렌더링됩니다.

기밀 문서에도 안전한가요?

네. 모든 처리는 브라우저 안에서 진행돼요. 입력은 이 페이지의 JavaScript가 파싱·재직렬화할 뿐 어떤 서버에도 전송되지 않습니다. 저장 버튼을 눌러도 네트워크 요청이 발생하지 않는 것을 개발자 도구에서 직접 확인할 수 있어요.

여러 PDF를 일괄 편집할 수 있나요?

이 UI는 한 번에 하나의 PDF만 편집해요 — 값을 명시적으로 적용하기 위해서예요. 일괄 편집이 필요하면 명령줄에서 pdf-lib를 사용해 CSV 등에서 값을 읽어 처리하는 편이 적절합니다.

작성자 필드가 왜 비어 있나요?

PDF는 작성자 필드를 반드시 채울 필요가 없어서 비어 있는 경우가 많아요. 폼은 문서에 들어 있는 값을 그대로 보여주며, 빈 입력은 작성자가 설정되지 않았다는 뜻이지 필드를 사용할 수 없다는 뜻이 아니에요.

저장 시 파일 크기가 변하나요?

약간 변할 수 있어요. pdf-lib가 PDF를 재직렬화하면서 의미는 같지만 바이트 인코딩이 달라질 수 있거든요. 보이는 콘텐츠와 메타데이터는 보존되고, 파일은 몇 KB 정도 더 크거나 작아질 수 있어요.

XMP 메타데이터도 편집할 수 있나요?

v1 에서는 안 돼요. 표준 필드만으로도 대부분의 워크플로우는 충분합니다. XMP 전용 태그(커스텀 스키마, 버전 이력)를 편집해야 한다면 XMP 를 다루는 전용 도구를 사용하세요 — pdf-lib는 이 UI에 깔끔하게 노출할 만큼의 표면을 제공하지 않습니다.