Astro 사이트의 CMS로 노션(Notion)을 선택한 이유: 기술과 에디터의 완벽한 분리
Astro는 현대 웹 프론트엔드 생태계에서 가장 가볍고 빠른 정적 사이트 생성기(SSG) 중 하나입니다. 자바스크립트를 배제한 제로 JS(Zero-JS) 아키텍처와 뛰어난 코어 웹 바이탈 성능 덕분에 미디어와 기술 블로그 구축에 있어 최고의 선택지로 평가받습니다.
하지만 개발팀의 만족도와 사이트의 뛰어난 성능 이면에는 언제나 한 가지 현실적인 장벽이 존재했습니다. 바로 "콘텐츠를 실제로 작성하고 관리하는 에디터들의 생산성" 문제입니다.
mktg.kr 사이트를 구축하며 수많은 Headless CMS 옵션 대신 Notion을 데이터베이스이자 CMS로 최종 낙점한 이유와, 이 조합이 미디어 및 팀 단위 조직에 제공하는 실무적 이점을 정리해 봅니다.
| 프레임워크 | 기반 언어 | 렌더링 모델 | 권장 CMS |
|---|---|---|---|
| Astro | JavaScript / TypeScript | Islands Architecture (SSG/SSR) | Notion, MicroCMS, Markdown |
| Hugo | Go (Golang) | Pure SSG (초고속 빌드) | Git 기반 Markdown 파일 |
| Next.js | React (TypeScript) | App Router (RSC, SSR, ISR) | Headless CMS, REST/GraphQL |
| 요약/권장 | 블로그 및 콘텐츠 사이트에는 Zero-JS 기반 Astro + Notion 조합이 최적 | ||
1. 깃(Git)과 마크다운의 높은 진입 장벽
전통적인 정적 사이트(SSG) 워크플로우는 대개 다음과 같이 운영됩니다:
1. 로컬 터미널을 열고 Git 브랜치를 생성한다.
2. `src/content/blog/` 디렉터리에 `.md` 파일을 생성한다.
3. YAML Frontmatter 문법(따옴표, 들여쓰기)을 엄격하게 지키며 메타데이터를 입력한다.
4. 마크다운 기호`(#, *, []())`와 HTML 태그를 직접 타이핑하며 본문을 작성한다.
5. Git Commit 후 Push를 통해 배포한다.
엔지니어에게는 익숙하고 빠른 방식이지만, 마케터, 기획자, 전문 필진, 에디터에게 이 과정은 거대한 진입 장벽입니다. 프론트매터 오타 하나로 빌드가 깨지거나, 이미지 경로 입력 실수로 이미지가 엑스박스로 뜨는 문제를 해결하느라 개발 리소스가 낭비되기 일쑤였습니다.
CMS의 첫 번째 원칙은 작성자가 문법과 도구의 두려움 없이 오직 생각과 글쓰기에만 몰입할 수 있어야 한다 는 점이었습니다.
2. 왜 수많은 Headless CMS 중 'Notion'이었는가?
Strapi, Sanity, Contentful, microCMS 등 시장에는 이미 강력한 Headless CMS 솔루션들이 많습니다. 하지만 우리는 다음과 같은 기준에서 Notion을 선택했습니다.
1) 이미 검증된 에디터 친화적 UI/UX
현재 대부분의 디지털 실무자는 협업, 문서화, 사내 위키 용도로 Notion을 일상적으로 사용하고 있습니다. 별도의 CMS 어드민 인터페이스 교육 없이도 슬래시(/) 명령어를 통해 제목, 글머리 기호, 콜아웃, 시맨틱 테이블, 유튜브 임베드까지 완벽하게 소화합니다.
2) 관계형 데이터베이스 기반의 완벽한 메타 관리
Notion의 데이터베이스 기능은 단순한 텍스트 에디터를 넘어 강력한 데이터 구조를 제공합니다.
Title, Slug, Date, Category, Tags, Author 등 SEO 필수 속성을 스프레드시트처럼 한눈에 보며 필터링하고 일괄 관리할 수 있습니다.
썸네일 이미지, 대체 텍스트(Alt Tag), 캡션까지 개발자 개입 없이 작성자가 직접 직관적인 폼에서 제어합니다.
3. Notion API + Deploy Hook: 미디어 조직에 최적화된 권한 모델
Astro와 Notion을 연동하면서 구현한 가장 강력한 워크플로우적 강점은 작성(Authoring)과 발행(Publishing) 권한의 깔끔한 분리 입니다.
[필진 / 에디터 그룹]
│ - Notion 워크스페이스에서 자유롭게 초안 작성
│ - 오타 수정, 이미지 교체, 속성값 설정
▼
[Notion 데이터베이스 (Draft 상태)]
│
│ (검수 완료 후 편집장 권한 승인: 'Published' 체크)
▼
[편집장 / 테크 리드]
│ - 배포 권한 통제 (원클릭 Deploy Hook 북마클릿 실행)
▼
[Cloudflare Pages 빌드 파이프라인]
│ - Astro 정적 페이지 일괄 생성
▼
[글로벌 엣지 배포 완료]
팀 단위 운영에서의 핵심 이점:
- 자유로운 워크스페이스 협업: 여러 에디터가 같은 Notion 데이터베이스에서 글을 쓰고, 피드백 댓글을 달고, 공동 편집할 수 있습니다.
- 배포 안정성 확보 (편집장 승인제): 일반 에디터가 글을 수정했다고 해서 사이트가 실시간으로 불안정하게 재빌드되지 않습니다. 글이 완벽히 준비되었을 때 상태를
Published로 전환하고, Deploy Hook을 누를 수 있는 권한을 가진 관리자(편집장)만이 배포 트리거를 발생시킵니다. - 인프라와 콘텐츠의 물리적 격리: 콘텐츠 작성자는 GitHub 저장소나 Cloudflare 대시보드 권한을 가질 필요가 전혀 없으므로 보안 사고나 코드 훼손의 위험이 0에 수렴합니다.
4. 가장 강력한 기술은 사용하기 쉬운 기술
Astro는 웹 성능의 극한을 추구하기에 가장 훌륭한 엔진이며, Notion은 현재 웹 환경에서 비개발자가 가장 편안하게 장문의 양질 콘텐츠를 생산할 수 있는 인터페이스입니다.
- 엔지니어는 Astro와 Cloudflare Pages의 무결점 성능, 극한의 SEO 점수, 모던 컴포넌트 생태계를 누립니다.
- 에디터는 복잡한 터미널과 마크다운 린트(Lint)에서 벗어나 검증된 Notion의 에디팅 경험을 그대로 누립니다.
Astro의 데이터 패칭 능력과 Notion API의 유연성을 결합한 이번 파이프라인은, 기술적 우수성과 실무 생산성 사이에서 고민하는 많은 미디어 조직과 기업 블로그에 가장 현실적이고 강력한 대안이 될 것입니다.