비개발자도 30분만에 만드는 Astro 블로그

2025년 11월 23일 learning by Seven Fingers Studio 12분

Astro블로그웹개발초보자무료블로그

“블로그 하나 만들어볼까?” 싶다가도 막상 찾아보면 머리가 아파지죠. 워드프레스는 뭔가 복잡하고, 티스토리는 내 맘대로 꾸미기 어렵고. 그래서 포기하신 분들 많을 거예요.

저도 그랬어요. 개발자 친구한테 물어보면 “React 배워”, “Next.js 써봐” 이런 말만 하고. 뭔 소린지 하나도 모르겠더라고요.

근데 Astro라는 걸 알게 됐는데, 이건 진짜 다릅니다. 복사 붙여넣기만 할 줄 알면 30분 안에 블로그가 뚝딱 만들어져요.

왜 Astro인가요?

일단 무료예요. 호스팅비 0원. 도메인만 사면 끝.

그리고 빠릅니다. 네이버 블로그나 티스토리보다 훨씬 빨라요. 구글 검색에도 잘 걸리고요. SEO라고 하는 건데, 쉽게 말해서 내 글이 검색 결과 상위에 뜰 확률이 높아진다는 거예요.

뭔가 어려워 보이는데 실제로 해보면 별거 없어요. 제가 단계별로 알려드릴게요.

딱 2개만 있으면 됩니다.

둘 다 검색해서 다운받으면 끝. 설치할 때 그냥 “다음” 버튼만 누르면 돼요.

VS Code를 열고, 상단 메뉴에서 Terminal > New Terminal 클릭하세요.

까만 창이 뜨면 이걸 복사해서 붙여넣기 하세요:

npm create astro@latest my-blog

뭔가 물어보면 그냥 엔터 치면 됩니다. 기본값으로 해도 충분해요.

아까 만든 폴더로 이동해야 해요. 터미널에 이렇게 입력:

cd my-blog

그 다음에 필요한 것들 설치:

npm install

좀 기다리면 알아서 다 설치돼요. 뭔가 주르륵 글자가 올라가는데 무시하셔도 됩니다.

자, 이제 내 블로그를 볼 차례예요:

npm run dev

터미널에 localhost:4321 이런 주소가 뜰 거예요. 그걸 Ctrl 누르고 클릭하면 브라우저에서 내 블로그가 열립니다.

어때요? 벌써 블로그가 생겼죠?

src/content/blog 폴더를 보세요. 거기에 .md 파일들이 있을 거예요. 이게 블로그 글이에요.

새 글 쓰고 싶으면 그냥 파일 하나 복사해서, 내용만 바꾸면 됩니다. 파일 맨 위에 제목이랑 날짜 적는 부분 있는데, 거기만 수정하면 돼요.

---
title: "내 첫 번째 글"
description: "블로그 시작했어요"
date: 2025-11-23
---

그 아래에 그냥 글 쓰면 됩니다. 마크다운이라고 하는 건데, 그냥 메모장에 글 쓰는 것처럼 하면 돼요.

무료로 공개하는 방법이 있어요. GitHub Pages라는 건데, 복잡하게 느껴질 수 있지만 한 번만 설정해두면 끝이에요.

GitHub 가입하고 (무료), 저장소 하나 만들고, 터미널에서:

npm run build

이러면 dist 폴더가 생기는데, 이걸 GitHub에 올리면 전 세계 누구나 내 블로그를 볼 수 있어요.

솔직히 처음엔 에러 메시지 보면 당황스러울 수 있어요. 저도 그랬거든요.

근데 대부분의 문제는 구글에 에러 메시지 복붙하면 답이 나와요. 아니면 ChatGPT한테 물어봐도 되고요.

제일 흔한 문제는 Node.js 버전이 낮은 거예요. node -v 쳐서 18 이상이면 괜찮아요.