기술 블로그를 Markdown과 정적 페이지로 만든 이유
콘텐츠는 오래 남고 운영은 단순하게. 글 중심 사이트에 필요한 기능과 관리 비용 사이의 균형.
글 중심의 기술 블로그에는 Markdown과 Astro 정적 빌드가 단순한 선택입니다. 데이터베이스 없이 HTML을 제공하고 Git으로 변경 이력을 관리할 수 있지만, 글 수정 후에는 다시 빌드하고 배포해야 합니다.
블로그에서 가장 중요한 데이터는 글입니다. 특정 편집기나 데이터베이스에만 묶어 두지 않으면 이전과 백업이 쉬워집니다.
글과 화면을 분리하기
Markdown에는 본문과 제목, 날짜, 주제 같은 메타데이터를 넣습니다. 화면의 레이아웃과 색상은 별도 컴포넌트와 스타일에서 관리합니다.
title: "새로운 기술 기록"
description: "이 글에서 다루는 핵심 내용"
date: 2026-10-13
summary: "선택한 방법과 핵심 결론을 두세 문장으로 설명합니다."
category: "웹 개발"
tags: ["실험", "기록"]
draft: true초안은 draft: true로 두고 공개할 준비가 되면 false로 바꿉니다. Git을 통해 글의 변경 이력도 코드처럼 살펴볼 수 있습니다.
요청할 때 계산하지 않기
정적 사이트는 배포 전에 HTML을 만들어 둡니다. 방문자가 글을 요청할 때 서버는 이미 만들어진 파일을 전달합니다. 읽기 중심의 작은 블로그라면 이 방식으로도 많은 일을 할 수 있습니다.
이 블로그의 검색과 주제 필터는 브라우저에서 동작하고 색상 테마는 방문자의 브라우저에 저장됩니다.
단순함의 비용도 있다
글을 수정하면 다시 빌드하고 배포해야 합니다. 관리 화면이나 실시간 댓글처럼 서버 상태가 필요한 기능은 별도로 설계해야 합니다. 현재는 글을 안정적으로 발행하는 흐름에 집중합니다.
다음 글을 발행하는 흐름
src/content/posts/에 Markdown 파일을 추가합니다.- 미리 보기에서 링크와 코드를 확인합니다.
- 빌드가 성공하는지 확인합니다.
- GitHub에 반영하고 배포합니다.
자세한 작성 방식은 Astro 공식 문서에서 확인할 수 있습니다.
정적 블로그에서 검색과 댓글을 사용할 수 있나요?
검색은 가능합니다. 이 블로그는 글 목록과 검색용 텍스트를 HTML에 포함하고 브라우저에서 결과를 거릅니다. 댓글처럼 사용자 데이터를 저장하는 기능은 별도의 서비스나 서버가 필요하며, 현재 이 블로그에는 댓글 기능이 없습니다.