Vercel에 올릴 블로그는 배포보다 빌드 구조가 더 중요합니다. 서버가 없어도 잘 동작하도록 모든 페이지를 정적으로 풀어낼 수 있어야 합니다.
이번 구조에서는 fs로 콘텐츠를 읽고, 빌드 단계에서 필요한 경로를 모두 생성합니다.
정리
복잡한 런타임 로직을 줄이면 유지보수도 함께 쉬워집니다.
콘텐츠 파이프라인
Vercel 배포를 염두에 두고 파일 기반 블로그 구조를 정리한 메모
특별한 서버 설정 없이도 정적으로 배포되도록, 빌드에서 필요한 데이터만 읽는 방향으로 구조를 맞췄습니다.
2026년 3월 3일읽는 시간 1분
22d52013
More Posts
다른 글도 함께 읽어보세요
문서 구조 개선
개발 문서에서 코드 예제와 설명이 자연스럽게 이어지도록 구성한 방법
코드 블록, 본문, 메타 정보의 간격을 다시 조정하면서 개발자용 블로그 페이지를 조금 더 차분하고 읽기 쉽게 다듬었습니다.
문서 구조 개선
타이포 위계를 다시 조정해 문서 페이지를 더 안정적으로 읽히게 만든 기록
본문은 크게 유지하고, h2와 h3의 대비를 분명하게 잡아 긴 글에서도 정보 흐름이 자연스럽게 이어지도록 구성했습니다.
콘텐츠 파이프라인
정적 생성에 맞춘 마크다운 파이프라인을 단순하게 유지하는 기준
파일 기반 콘텐츠를 읽어 빌드 시점에 정리하고, 상세 페이지와 태그 페이지까지 한 흐름으로 이어지게 만들었습니다.
미디엄 스타일 분석
에디토리얼 리스트 레이아웃을 살리기 위해 카드 대신 행 구조를 선택한 이유
스크린샷의 인상을 유지하려면 카드보다 텍스트와 이미지가 나란히 놓인 세로 리스트가 더 적절했습니다.
콘텐츠 파이프라인
태그 체계를 느슨하게 유지하면서도 탐색성이 떨어지지 않게 만든 메모
태그를 너무 잘게 쪼개지 않고도 관련 글을 묶어 보여주기 위해 최소한의 규칙만 정리했습니다.
미디엄 스타일 분석
시리즈 탐색 페이지를 따로 둬야 글 흐름이 더 선명해지는 이유
관련된 글을 시간순만으로 찾기 어렵기 때문에, 시리즈 단위 진입점을 별도 페이지로 구성했습니다.