AX (AI Transformation) 시대, 콘텐츠의 작성은 AI와 협업하고 출판은 기계적으로 자동화한다. 이 문서는 그 워크플로우에 최적화된 Headless CMS와 SSG 조합을 추천한다.
핵심 전제: 문서 형식의 이중 표준
| 단계 | 최적 표준 형식 | 이유 |
|---|---|---|
| 작성 (AI 협업) | Frontmatter + Markdown | 사람과 AI 모두 읽고 쓰기 쉬움. 메타데이터(frontmatter)와 본문이 하나의 파일에 공존. Git diff 친화적. |
| 출판 (기계적 빌드) | HTML | 브라우저 네이티브. SSG가 Markdown → HTML 변환을 자동 처리. CDN 배포에 최적. |
Frontmatter가 포함된 Markdown은 AI 에이전트가 제목, 태그, 날짜, 카테고리 등 구조화된 메타데이터를 정확히 파싱·생성할 수 있어 AI 협업의 사실상 표준이다.
Headless CMS × SSG: 다대다 관계
Headless CMS는 콘텐츠를 관리하는 백엔드(body without a head)이고, SSG는 거기에 UI(head)를 입혀 정적 사이트를 생성하는 프론트엔드 빌드 도구다. 이 둘은 다대다(M:N) 관계로 연결된다.
graph LR
subgraph "Headless CMS"
A["Front Matter CMS"]
B["Decap CMS"]
C["Pages CMS"]
D["GitCMS"]
end
subgraph "SSG"
E["Astro"]
F["Hugo"]
G["Quarto"]
end
A --- E
A --- F
A --- G
B --- E
B --- F
B --- G
C --- E
C --- F
D --- E
D --- F
- 하나의 CMS(예: Decap CMS)는 여러 SSG(Astro, Hugo, Jekyll 등)를 지원
- 하나의 SSG(예: Astro)는 여러 CMS(Front Matter, Decap, Sanity 등)를 콘텐츠 소스로 연결 가능
- CMS와 SSG를 독립적으로 선택할 수 있어, 락인 없이 조합을 바꿀 수 있다
Headless CMS 추천
🏆 1순위: Local — Google Antigravity IDE + Front Matter CMS Extension
비용 제로 · 속도 최고 · 락인 제로 · Git 네이티브
Google Antigravity는 Gemini 기반 에이전트형 IDE로, 2025년 말 출시되었다. VS Code 계열 확장을 지원하며, Front Matter CMS 확장을 설치하면 로컬 파일 시스템 위에서 완전한 Headless CMS 환경이 구축된다.
- Front Matter CMS: Markdown frontmatter 스키마 정의, 콘텐츠 대시보드, 미디어 관리, 미리보기를 IDE 안에서 제공
- AI 에이전트가
.md파일을 직접 생성·편집 → 별도 API 호출 불필요 - 로컬 Git 리포에 저장 →
git commit/push로 버전 관리 완료 - 클라우드 서비스 의존 없음 → 비용 $0, 오프라인 작업 가능
왜 Cloud CMS(Notion, Contentful 등)보다 우월한가:
| 비교 항목 | Local (Antigravity + Front Matter) | Cloud CMS (Notion, Contentful 등) |
|---|---|---|
| 비용 | 무료 | 무료 티어 제한 or 유료 |
| 속도 | 로컬 파일 I/O (즉시) | API 지연 + Rate limit |
| 락인 | 없음 (표준 Markdown 파일) | 독자 포맷, 마이그레이션 비용 |
| 버전 관리 | Git 네이티브 | 벤더 자체 히스토리 (제한적) |
| AI 연동 | IDE 내 에이전트가 파일 직접 조작 | API 중간 계층 필요 |
2순위: Cloud 대안 (Git-based CMS)
로컬 IDE 환경이 부담스럽거나, 웹 브라우저만으로 편집하고 싶다면 아래 옵션이 있다.
① Decap CMS (구 Netlify CMS)
- Netlify가 만든 오픈소스, 무료
- GitHub/GitLab 리포와 연동, OAuth 인증 후 웹 UI에서 Markdown 편집
- 다수의 SSG 공식 지원 (Hugo, Gatsby, Astro, Jekyll, Eleventy 등)
- 커뮤니티 유지보수 중 — 업데이트 속도는 느린 편
- 모던 대안으로 Sveltia CMS (Decap 호환 드롭인 대체제, 더 나은 UI/UX)
② Pages CMS
- 1인 개발자가 만든 오픈소스, 무료
- GitHub Web Interface에서 바로 Markdown 문서 편집
- 설정 파일 하나로 콘텐츠 스키마 정의
- 가볍고 빠르지만, 기능 범위는 제한적
③ GitCMS
- GitHub 위에서 Notion-like 에디터 경험 제공 (Chrome 확장)
- 커스텀 frontmatter 스키마, 비주얼 Markdown 편집
- Next.js, Astro, Hugo, Jekyll, Eleventy 등 주요 SSG 모두 지원
- 거의 유료 — 무료 티어 제한 있음
SSG 도구 추천
SSG는 무엇을 써도 CMS와 조합 가능하다. 용도별 추천:
| SSG | 언어 | 핵심 강점 | 추천 상황 |
|---|---|---|---|
| Astro | JavaScript | Island Architecture, 다양한 프레임워크 혼용 (React, Vue, Svelte), 풍부한 인테그레이션 | 이것저것 서비스를 붙일 것 같을 때. CMS 연동·API 콜·인터랙티브 컴포넌트가 필요한 사이트. |
| Hugo | Go | 수천 페이지도 수 초 내 빌드. 단일 바이너리, 의존성 없음. | Lightweight & Fast를 최우선할 때. 대규모 문서 사이트, 블로그. |
| Quarto | Python/R/Julia | HTML, PDF, ePub, Word, Reveal.js 슬라이드 등 다중 출판 형식 지원. 코드 실행 결과 인라인 렌더링. | 학술 논문, 기술 문서, 전자책 등 다양한 출판 포맷이 필요할 때. |
빌드 → 배포: AI가 처리하는 기계적 단계
SSG 빌드 + CDN 배포는 정형화된 반복 작업이다. AI-assisted IDE가 가장 잘하는 영역.
전체 파이프라인:
- 콘텐츠 작성 — AI 에이전트와 Markdown 파일 작성/편집
- SSG 빌드 —
astro build/hugo/quarto render한 줄 - CDN 배포 — GitHub Pages, GitLab Pages, Cloudflare Pages, Netlify 등 무료 호스팅에 push
이 2→3 단계는 완전히 기계적이므로:
- Google Antigravity IDE: 에이전트에게 "빌드하고 배포해"라고 지시하면 터미널 명령 자동 실행
- Claude Code: 터미널 접근 가능한 AI 에이전트가 동일 작업 수행
- CI/CD 파이프라인(GitHub Actions 등)을 한 번 세팅하면
git push만으로 자동 배포
핵심: 작성 단계에 인간의 판단과 AI의 생성력을 집중하고, 빌드·배포는 자동화에 맡긴다.
추천 조합 요약
| 프로필 | CMS | SSG | 배포 |
|---|---|---|---|
| 개발자 · 퀀트해커 | Antigravity + Front Matter CMS | Astro 또는 Hugo | Cloudflare Pages |
| 연구자 · 저자 | Antigravity + Front Matter CMS | Quarto | GitHub Pages |
| 비개발자 · 웹 편집 선호 | Decap CMS 또는 Pages CMS | Hugo | Netlify |
| Notion-like UX 필요 | GitCMS (유료) | Astro | Cloudflare Pages |