PDFVela — pdfvela.com
모든 PDF 도구

Base64 문자열을 PDF 파일로 저장하는 방법

API 응답, 인보이스 XML, 이메일 원본에 JVBERi0로 시작하는 긴 텍스트가 있고 그 안의 문서가 필요하다면, 코드를 찾는 법부터 파일을 여는 법까지 차례대로 따라 하세요.

작성자 · 2026년 11월 10일 업데이트

Base64 PDF란 무엇이고, 왜 텍스트로 오나요?

Base64는 파일을 영문자, 숫자, 몇 가지 기호만으로 적는 방식입니다. 덕분에 JSON, XML, 이메일처럼 텍스트만 다루는 형식에도 PDF를 담을 수 있습니다. 코드에는 문서가 그대로 복사되어 있어서, 디코딩하면 원본 파일이 바이트 하나까지 똑같이 돌아오고 디지털 서명도 유효한 상태로 남습니다.

주로 이런 곳에서 만나게 됩니다.

  • 인보이스·회계 API. 전자 인보이스 플랫폼과 회계 소프트웨어는 인보이스의 PDF 버전을 Base64 필드로 돌려주는 경우가 많습니다. UBL 같은 구조화된 인보이스 XML도 인쇄용 PDF를 같은 방식으로 담을 수 있습니다.
  • 배송. 배송을 등록하면 택배사는 보통 운송장을 Base64 PDF로 돌려줍니다.
  • 결제·은행. 영수증, 급여 명세서, 거래 내역서 서비스가 문서를 텍스트 필드에 담아 보내기도 합니다.
  • 전자 서명·문서 플랫폼. 서명이 끝난 문서가 서명 서비스에서 Base64로 돌아옵니다.
  • 이메일 원본. 이메일의 원본 소스에서 PDF 첨부 파일은 Base64 블록으로 저장되어 있습니다.

1. 코드를 찾아 빠짐없이 복사하기

  • JSON 응답: PDF가 들어 있는 필드를 찾으세요. 이름은 pdf, content, data, document, file, label 같은 경우가 많고, 값은 JVBERi0로 시작합니다. 따옴표 사이의 내용을 모두 복사하세요. 응답 전체를 복사해도 됩니다. 도구가 JVBERi0로 시작하는 부분을 알아서 찾아냅니다.
  • XML 파일: PDF가 담긴 요소(예: EmbeddedDocumentBinaryObject)를 찾아 여는 태그와 닫는 태그 사이의 텍스트를 복사하세요. 줄바꿈이 섞여 있어도 괜찮습니다.
  • 이메일 원본: “원본 보기”나 “소스 보기” 같은 메뉴를 여세요. Content-Type: application/pdf 줄과 Content-Transfer-Encoding: base64 줄 아래에 있는 블록이 PDF 첨부 파일입니다. 다음 빈 줄이 나오기 전까지 모두 복사하세요.
  • 개발자 도구: 브라우저의 Network(네트워크) 탭에서 응답을 열고 필드를 마우스 오른쪽 버튼으로 클릭한 뒤 “Copy value”(값 복사)를 고르세요. 긴 문자열을 손으로 드래그해 선택하는 것보다 훨씬 확실합니다.

코드가 워낙 길어서 끝부분이 잘리기 쉽습니다. 복사한 뒤에는 붙여 넣은 내용의 끝이 원본과 똑같이 끝나는지 확인하세요.

2. 코드를 변환하고 문서 확인하기

Base64를 PDF로 변환을 열고 “또는 텍스트 입력/붙여 넣기”를 누른 뒤 코드를 붙여 넣으세요. 디코딩이 끝나면 바로 첫 페이지가 나타나고, 그 아래에 페이지 수, PDF 버전, 파일 크기가 표시됩니다. 코드가 .txt 파일에 저장되어 있다면 그 파일을 선택하기만 하면 됩니다.

미리 보기로 다음을 빠르게 확인할 수 있습니다.

  • 원하는 문서가 맞나요? 첫 페이지에서 인보이스 번호, 고객 이름, 운송장 정보를 확인할 수 있습니다.
  • 페이지 수가 예상과 같나요? 페이지가 모자라면 코드가 일부만 복사된 것입니다.
  • 암호가 걸려 있나요? 그렇다면 미리 보기 대신 안내 문구가 나타나며, 파일은 그래도 원래 상태 그대로 저장됩니다.

3. PDF를 저장하고 열기

“PDF 다운로드”를 누르세요. 파일은 아무것도 바뀌지 않은 채 저장되며 어떤 PDF 뷰어에서도 열립니다. 그다음은 필요에 따라 고르면 됩니다. 한 달 치 인보이스를 PDF 합치기로 한 파일에 모으거나, PDF 압축으로 이메일에 첨부할 만큼 용량을 줄이거나, PDF를 JPG로 변환으로 첫 페이지를 이미지로 만들 수 있습니다.

코드의 시작 부분으로 알 수 있는 것

코드의 시작 부분안에 든 파일
JVBERi0PDF 문서
data:application/pdf;base64,PDF 문서(데이터 URI)
iVBORw0KGgoPNG 이미지
/9j/JPG 사진
UEsDBZIP, 워드(.docx), 엑셀(.xlsx)
PD94bWwgXML 텍스트(예: 인보이스 데이터 자체)

마지막 줄은 전자 인보이스에서 자주 생기는 혼동을 설명해 줍니다. 일부 서비스는 PDF 대신 인보이스 XML을 Base64로 보냅니다. 이 코드를 디코딩하면 문서가 아니라 읽을 수 있는 XML 텍스트가 나옵니다.

자주 하는 실수

코드를 .pdf 확장자의 텍스트 파일로 저장하기. 파일 안에는 여전히 Base64 텍스트가 들어 있어서 PDF 뷰어는 파일이 손상되었다고 표시합니다. 코드를 디코딩해야 합니다.

값보다 더 많이 복사하기. 코드 끝에 “,”나 “status” 같은 글자가 딸려 들어가면 코드가 올바르지 않게 됩니다. 값만 복사하거나 아예 응답 전체를 복사하세요. 도구는 두 경우 모두 코드를 정확하게 뽑아냅니다.

이스케이프된 줄바꿈. JSON 문자열에서는 코드가 76자마다 \n으로 나뉘어 있을 수 있습니다. 이 문자는 PDF의 일부가 아니며, 도구가 자동으로 지워 줍니다.

잘못된 응답. 문서가 아직 준비되지 않았으면 일부 API는 빈 필드나 오류 메시지를 돌려줍니다. 코드가 몇백 자 정도로 아주 짧다면 PDF가 아니라 오류 메시지일 가능성이 큽니다.

개인정보 보호에 관한 참고 사항

Base64는 문서를 보호하지 않으며, 형식만 바꿀 뿐입니다. 인보이스, 계약서, 진단서, 신분증 사본은 파일을 서버로 업로드하는 사이트에서 디코딩하지 마세요. PDFVela 도구는 사용 중인 기기에서 코드를 디코딩하며, 페이지가 열린 뒤에는 인터넷 연결이 끊겨도 계속 작동합니다.

직접 사용해 보시겠어요? 무료이며 파일은 내 기기에만 머뭅니다.

Base64를 PDF로 변환 열기

Base64를 PDF로 변환할 때 자주 묻는 질문

문자열이 Base64 PDF인지 어떻게 알 수 있나요?

가장 확실한 표시는 JVBERi0로 시작하는지입니다. 모든 PDF의 첫 글자인 %PDF-를 인코딩하면 이렇게 보입니다. data:application/pdf;base64,로 시작하는 문자열도 PDF입니다. 코드에는 영문자, 숫자, +, /만 들어 있고, 끝에 = 기호가 한두 개 붙을 수 있습니다.

코드를 그대로 파일에 붙여 넣고 이름을 .pdf로 바꾸면 안 되나요?

안 됩니다. 확장자를 .pdf로 저장해도 파일 안에는 여전히 텍스트가 들어 있어서 PDF 뷰어가 열지 못합니다. 먼저 코드를 원래 바이트로 디코딩해야 합니다. Base64를 PDF로 변환 도구가 브라우저에서 이 작업을 해 줍니다.

전자 인보이스 XML 안에서 PDF는 어디에 있나요?

인보이스의 인쇄용 버전은 보통 mimeCode="application/pdf"가 붙은 EmbeddedDocumentBinaryObject 같은 요소에 들어 있습니다. 이 요소 안의 텍스트 전체가 PDF의 Base64 코드입니다. 서비스에 따라 PDF 대신 HTML이나 XSLT 스타일시트를 보내기도 하는데, 이런 코드는 JVBERi0로 시작하지 않습니다.

기밀 문서인데 안전한가요?

PDFVela 도구는 사용 중인 기기에서 코드를 디코딩하며, 텍스트도 문서도 서버로 전송되지 않습니다. Base64는 암호화가 아니어서 코드만 있으면 누구나 문서를 열 수 있습니다. 인보이스, 계약서, 신분증 스캔본을 붙여 넣기 전에 그 사이트가 파일을 업로드하는지 꼭 확인하세요.

코드에 이미지가 들어 있으면 어떻게 하나요?

iVBORw0KGgo(PNG)나 /9j/(JPG)로 시작하는 코드는 이미지입니다. Base64를 PDF로 변환 도구가 이를 알아채고 Base64를 이미지로 변환 도구를 안내합니다. 이미지를 저장한 뒤 필요하면 JPG를 PDF로 변환 도구로 PDF를 만들 수 있습니다.