콘텐츠 컬렉션이 필요한 이유
Astro에서 글은 보통 Markdown 파일로 관리합니다. 파일만 읽어도 사이트는 만들 수 있지만, 글마다 제목이나 날짜의 이름이 제각각이면 곧 관리가 어려워집니다. 콘텐츠 컬렉션은 모든 글이 같은 규칙을 따르도록 지켜주는 장치입니다.
이 블로그에서는 src/content/notes 폴더 안의 파일을 하나의 컬렉션으로 묶었습니다. 제목, 한 줄 설명, 작성일, 분류, 태그를 정해둔 형식으로 적으면 Astro가 사이트를 만들기 전에 잘못된 부분을 알려줍니다.
글 한 편의 구조
Markdown 파일은 크게 두 부분입니다. 위쪽의 --- 사이에는 글의 정보가 들어가고, 아래에는 실제 본문이 들어갑니다.
---
title: "첫 번째 기록"
description: "이 글을 한 문장으로 소개합니다."
publishedAt: 2026-08-20
category: it
tags: ["Astro"]
draft: false
featured: false
accent: lime
---
## 첫 번째 제목
여기부터 본문을 씁니다.꼭 기억할 세 가지
- 파일 이름은 글 주소가 됩니다.
draft: true로 바꾸면 사이트에서 잠시 숨길 수 있습니다.- 날짜는
YYYY-MM-DD형식으로 적습니다.
글을 발행하는 흐름
이 사이트의 /studio에서 글을 쓰고 src/content/notes 폴더에 저장합니다. 로컬 화면에서 결과를 확인한 다음 GitHub에 올리면 Cloudflare Pages가 새 사이트를 자동으로 만듭니다.
데이터베이스는 없지만, 글의 모든 변경 이력이 GitHub에 남습니다. 개인 아카이브에는 오히려 이 단순함이 큰 장점입니다.
다음에 해볼 것
글이 많아지면 태그별 페이지와 전문 검색을 추가할 수 있습니다. 하지만 처음에는 분류 세 개와 제목 검색만으로도 충분합니다. 기능보다 기록하는 습관을 먼저 만드는 편이 오래 갑니다.