[💡] 네이버 블로그 PDF 백업을 GitHub Pages로 옮긴 이야기

✨ GPT의 요약 　

네이버 블로그 PDF 백업 18개에서 글 173개와 이미지 1521개를 추출해, 기존 GitHub Pages 블로그 구조 안으로 다시 이식한 기록.

네이버 블로그에 쌓아둔 글들을 다시 GitHub Pages 블로그로 가져오고 싶어졌다.

정확히는, 단순히 백업 파일을 어딘가에 보관하고 싶은 정도가 아니었다. 이미 쓴 글들이 있었다. 날짜도 있었고, 이미지도 있었고, 카테고리도 있었고, 그 시기의 생각도 있었다. 그런데 그 기록들이 네이버 블로그라는 다른 집에 따로 놓여 있었다.

나는 결국 이 블로그를 내 기록의 중심으로 다시 세우고 싶었다. 예전에 Jekyll과 GitHub Pages로 블로그를 시작하는 이야기를 적었을 때의 마음과 비슷했다. 무료 정적 블로그라는 틀은 단순하지만, 그 안에 내가 원하는 방식으로 기록을 쌓을 수 있다는 점이 마음에 들었다.

다만 이번에는 새 글을 하나 쓰는 문제가 아니었다.

네이버 블로그 PDF 백업 18개를 받아서, 그 안에 들어 있는 글과 이미지를 기존 Jekyll 블로그 구조 안으로 다시 옮겨야 했다.

조건부터 정했다

처음부터 목표는 단순했다.

네이버 블로그 백업을 가져오되, 이 블로그 안에서 원래부터 있었던 글처럼 읽히게 만들고 싶었다.

조건을 몇 개 정했다.

• PDF 18개 안의 글을 빠짐없이 추출한다.
• 글의 날짜와 원문 링크를 남긴다.
• 이미지는 기존 블로그 관례에 맞춰 assets/images/YYYY-MM/YYYY-MM-DD/ 아래에 둔다.
• 오늘 하루는 시리즈 번호는 기존 글과 이어지게 한다.
• 맛집, 여행, AI, 개발 같은 글은 오늘 하루는 번호에 섞지 않는다.
• 기존 카테고리에 억지로 밀어 넣지 말고, 필요하면 새 카테고리를 만든다.
• PDF에서 깨진 문장을 그대로 들여오지 않는다.
• 결과물은 빌드 가능한 Jekyll 글이어야 한다.

말로 쓰면 평범하다. 그런데 막상 해보니 이건 그냥 파일 복사가 아니었다.

기록을 다른 시스템으로 이사시키는 작업이었다.

PDF 텍스트만 믿으면 안 됐다

처음에는 PDF에서 텍스트와 이미지를 뽑으면 끝날 줄 알았다.

실제로 글은 추출됐다. 이미지도 추출됐다. 그런데 문제는 본문이었다. PDF에서 가져온 문장들이 중간중간 이상하게 끊어져 있었다.

예를 들면 이런 식이었다.

그 거대한 폭풍을 나 혼자서 하루빨리 통제하려고 하는 그런 과한 의욕 자체가 나를 무기력하게 만드는 가장 큰 원인이기

때문이다.

문장 하나가 문단처럼 갈라지고, 단어가 쪼개지고, 읽는 리듬이 망가졌다.

이 상태로 옮기면 백업은 될지 몰라도 글은 망가진다. 사람이 읽는 글이 아니라, PDF에서 뜯겨 나온 흔적에 가까웠다.

그래서 방향을 바꿨다.

PDF는 글 목록과 이미지 추출의 출발점으로 쓰고, 본문은 네이버 원문 HTML을 다시 읽어서 복구했다. 네이버 에디터의 문단, 목록, 인용 흐름을 따라가면서 Markdown 본문으로 다시 만들었다.

그제야 글이 글처럼 돌아왔다.

이미지는 기존 블로그 방식에 맞췄다

이미지도 중요했다.

네이버 글은 이미지가 많았다. 특히 여행 글이나 맛집 글은 이미지가 본문 그 자체에 가까웠다. 텍스트만 옮기면 반쪽짜리 기록이 된다.

최종적으로 가져온 이미지는 1521개였다.

이미지 경로는 기존 블로그 관례에 맞췄다.

assets/images/2025-09/2025-09-09/naver-004-001.jpg

연도-월, 날짜, 그리고 네이버 import 번호가 들어간 파일명으로 정리했다. 이렇게 해두면 나중에 파일을 봐도 어느 날짜의 어떤 import 이미지인지 추적할 수 있다.

본문에서는 일반 Markdown 이미지 문법을 그대로 썼다.

![naver-004-001](/assets/images/2025-09/2025-09-09/naver-004-001.jpg)

정적 블로그에서는 이런 단순함이 중요하다. 빌드가 끝나면 그냥 파일이다. 별도의 이미지 서버나 외부 링크에 기대지 않아도 된다.

카테고리는 다시 나눴다

가장 조심스러웠던 부분은 카테고리였다.

처음에는 네이버 글들을 대충 diary 아래로 넣으면 되지 않을까 싶었다. 하지만 그렇게 하면 나중에 글을 찾기도 어렵고, 블로그 구조도 흐려진다.

그래서 새 카테고리를 만들었다.

diary life
diary thought
diary relationship
diary restaurant
diary travel

기존에 있던 diary ai, diary dev, diary religion도 함께 썼다. 독서/마인드셋 글은 reading mindset, 앱이나 블로그 팁은 tip 하위 카테고리에 넣었다.

카테고리를 새로 만드는 건 파일 하나 옮기는 것으로 끝나지 않는다.

카테고리 페이지가 필요하다. 사이드바 네비게이션도 필요하다. 아카이브에서 보이는 카테고리 라벨과 링크도 맞춰야 한다. 제목 앞 아이콘도 기존 블로그 관례와 맞아야 한다.

맛집 글은 [🍽️], AI 글은 [🤖], 개발 글은 [💻], 여행 글은 [🧳]처럼 정리했다.

사소해 보이지만 이런 부분이 흐트러지면, 가져온 글들이 계속 외부에서 온 이물질처럼 보인다.

오늘 하루는 번호는 따로 지켰다

가장 헷갈리기 쉬웠던 것은 오늘 하루는 번호였다.

네이버에 있던 오늘의 인증 글들은 사실상 Daily Review였다. 그래서 기존 블로그의 오늘 하루는 시리즈와 이어져야 했다.

반대로 맛집, 여행, AI, 독서 글은 아무리 날짜가 비슷해도 오늘 하루는 시리즈가 아니다. 이 글들까지 번호에 섞으면 시리즈 자체가 망가진다.

최종 결과는 이렇게 맞췄다.

오늘 하루는 #1 ~ #200

번호는 1번부터 200번까지 이어졌고, 누락이나 중복이 없었다. 비-Daily Review 글에는 오늘 하루는 # 번호가 들어가지 않도록 확인했다.

이건 단순한 숫자 정리가 아니었다.

시리즈의 정체성을 지키는 작업이었다.

검증이 작업의 절반이었다

이런 이관 작업에서 무서운 건, 겉으로는 그럴듯해 보이는데 어딘가 하나씩 틀어지는 것이다.

이미지 파일이 없는데 Markdown만 남아 있을 수 있다. 카테고리 front matter와 실제 폴더가 어긋날 수 있다. 제목 아이콘이 기존 관례와 다를 수 있다. PDF에서 깨진 ? 아이콘이 본문에 그대로 남을 수 있다.

그래서 검증을 따로 돌렸다.

확인한 것은 대략 이렇다.

import 글: 173개
이미지 참조: 1521개
이미지 누락: 0개
보이는 단독 ? 잔여: 0개
오늘 하루는 번호: #1 ~ #200
비-Daily Review 번호 섞임: 0개
카테고리 폴더 불일치: 0개

마지막에는 Jekyll 빌드도 돌렸다.

bundle exec jekyll build

정적 블로그는 빌드가 통과해야 비로소 안심할 수 있다. Markdown 하나의 Liquid 문법이 깨져도 전체 사이트가 멈출 수 있기 때문이다.

결과

결과적으로 네이버 블로그 PDF 백업 18개에서 글 173개와 이미지 1521개를 이 블로그로 옮겼다.

하지만 숫자보다 중요한 건 따로 있다.

이 작업은 단순한 백업이 아니었다. 흩어진 기록을 다시 하나의 시스템 안으로 복원하는 작업이었다.

PDF, 네이버 HTML, Jekyll front matter, 카테고리 페이지, 사이드바 네비게이션, 이미지 경로, 시리즈 번호가 전부 맞아야 했다. 하나만 틀어져도 기록의 맥락이 깨진다.

이전에 GitHub Pages 블로그에 방문자 카운터 붙이기를 하면서 느꼈던 것과 비슷하다. 기능 하나만 보면 거창하지 않다. 하지만 실제 불편함에서 시작했고, 무료 정적 블로그라는 제약 안에서, 운영 가능한 형태로 끝까지 붙였다는 점이 중요했다.

이번 import도 그렇다.

남들이 보기에는 그냥 글 옮기기일 수 있다. 하지만 내 입장에서는 기록 시스템을 다시 정비한 작업이었다.

앞으로 이 블로그를 포트폴리오처럼 보여줄 일이 있다면, 이런 작업이 오히려 설명하기 좋을 것 같다. 단순히 글을 많이 썼다는 이야기가 아니라, 내가 쌓아온 기록을 어떻게 구조화하고, 망가진 데이터를 어떻게 복구하고, 기존 시스템의 관례 안에 어떻게 안착시켰는지를 보여주는 사례가 되기 때문이다.

기록은 쓰는 것도 중요하지만, 잃어버리지 않게 다시 붙잡아두는 것도 중요하다.

이번 작업은 그쪽에 가까웠다.