“네이버 블로그나 워드프레스에는 ‘글쓰기’ 버튼이 있는데, Astro 블로그는 도대체 어디에 글을 써야 하나요?”
2편에서 나만의 블로그 주소를 만들고 나면 가장 먼저 드는 궁금증입니다. Astro 블로그에는 별도의 관리자 로그인 페이지가 없습니다. 대신 내 컴퓨터의 폴더 안에 메모장 파일 하나를 추가하는 것 자체가 곧 글쓰기입니다.
처음에는 “메모장에 기호를 넣어서 글을 쓴다고?” 하며 낯설게 느껴질 수 있지만, 딱 10분만 따라 해 보시면 왜 전 세계의 개발자·작가·노션(Notion) 사용자들이 마우스에 손도 대지 않고 글을 쓸 수 있는 마크다운(Markdown, .md) 방식에 열광하는지 바로 체감하시게 됩니다.
이번 3편에서는 ① 새 글을 어느 폴더에 만들어야 하는지, ② .md 파일의 핵심 문법 7가지는 무엇인지, 그리고 ③ 구글과 독자 모두가 좋아하는 5단계 글쓰기 공식까지 완벽하게 정리해 드립니다.
1. 새 블로그 글은 어디에 만드나요?
내 컴퓨터의 블로그 프로젝트 폴더(my-blog 또는 innislives-blog)를 열어보면 다음과 같은 경로가 있습니다.
👉 src 폴더 ➔ content 폴더 ➔ blog 폴더
바로 이 src/content/blog/ 폴더가 내 블로그의 글 보관함입니다!
이 폴더 안에 **ai-trends-2026.md**라는 이름으로 새 파일을 하나 만들면, 내 블로그에 자동으로 **https://내블로그주소/blog/ai-trends-2026/**이라는 새 글 페이지가 생성됩니다.
- 꿀팁: 파일 이름은 곧 인터넷 주소(URL)가 되므로, 띄어쓰기 대신 빼기 기호(
-)를 사용한 영문 소문자(예:astro-blog-guide.md)로 짓는 것이 가장 깔끔합니다.
2. 마크다운(.md) 파일의 2층 구조 이해하기
모든 블로그 .md 파일은 위아래 2층으로 나뉩니다. 이 구조만 기억하시면 절대 오류 날 일이 없습니다.
[1층] 글의 신분증: 머릿말 (Frontmatter)
파일의 맨 첫 줄(---)부터 두 번째 --- 사이의 공간입니다. 여기에는 검색엔진과 블로그 목록 화면에 보여줄 제목, 요약 설명, 작성일, 카테고리, 해시태그를 적습니다.
[2층] 실제 이야기: 본문 (Body)
두 번째 --- 아래부터는 독자가 읽게 될 실제 본문을 자유롭게 적는 공간입니다.
아래의 완성된 예시 템플릿을 그대로 복사해서 새 글의 시작점으로 사용해 보세요!
---
title: "직장인이 주말 1시간 투자로 평생 무료 블로그 만든 후기"
description: "서버비 0원으로 나만의 기술·수익형 블로그를 구축한 과정과 노하우를 공유합니다."
pubDate: "2026-11-17"
category: "웹/앱 개발"
tags: ["블로그구축", "Astro", "자기계발", "디지털노마드"]
featured: true
draft: false
tldr:
- "첫 번째 핵심 요약 문장을 여기에 적습니다."
- "두 번째 핵심 요약 문장을 여기에 적습니다."
faq:
- question: "독자가 가장 궁금해할 질문 1번은?"
answer: "그에 대한 명쾌한 답변을 2~3문장으로 적습니다."
---
여기에 도입부 인사말을 적습니다.
## 1. 첫 번째 큰 소제목입니다
본문 내용은 그냥 일반 타자 치듯이 편안하게 적으시면 됩니다.
중요한 단어는 **이렇게 별표 두 개로 감싸면 굵은 글씨**가 됩니다.
3. 평생 이것만 쓰면 되는 마크다운 필수 문법 7가지
수십 가지 문법을 외울 필요가 전혀 없습니다. 실제 블로그 글의 99%는 아래 7가지 기호만으로 작성됩니다.
| 순서 | 표현하고 싶은 서식 | 마크다운 작성 방법 | 주의할 점 (핵심 포인트) |
|---|---|---|---|
| 1 | 큰 소제목 (H2) |
## 1. 소제목 내용 |
# 기호 뒤에 반드시 띄어쓰기 한 칸! |
| 2 | 작은 소제목 (H3) |
### ① 세부 소제목 |
큰 소제목(##) 아래에 하위 주제를 나눌 때 사용 |
| 3 | 굵은 글씨 강조 | **강조할 핵심 문장** |
양쪽의 **와 글자 사이에 빈칸 없이 딱 붙여 쓰기 |
| 4 | 점(•) 목록 |
- 첫 번째 항목 |
- 기호 뒤에 띄어쓰기 한 칸 |
| 5 | 인용구 강조 박스 | > "핵심 명언이나 한 줄 요약" |
문단 맨 앞에 > 기호를 붙이면 멋진 배경 박스 생성 |
| 6 | 클릭 가능한 링크 | [구글 바로가기](https://google.com) |
대괄호 [ ]엔 보여줄 글자, 소괄호 ( )엔 주소 |
| 7 | 사진(이미지) 넣기 |  |
사진 파일은 미리 public/images/ 폴더 안에 넣어두기 |
4. 독자와 검색엔진을 사로잡는 ‘5단계 블로그 글쓰기 공식’
마크다운 문법을 알았다면, 이제 **“어떤 순서로 글을 써야 사람들이 끝까지 읽고 검색 상단에 노출될까?”**를 알아볼 차례입니다. 고수익 블로거들이 공통적으로 사용하는 5단계 구조입니다.
- 도입부 공감 훅 (Hook - 3~4줄):
- 독자가 왜 이 글을 검색했는지 가려운 곳을 긁어주는 질문이나 인용구(
>)로 시작합니다.
- 독자가 왜 이 글을 검색했는지 가려운 곳을 긁어주는 질문이나 인용구(
- 핵심 3줄 요약 (
tldr활용):- 바쁜 현대인은 결론부터 보고 싶어 합니다. 이 글을 읽으면 얻게 될 핵심 해답 3가지를 상단에 먼저 제시합니다.
- 번호가 매겨진 소제목(
## 1.,## 2.)과 단계별 해결책:- 줄글만 길게 이어지면 독자는 창을 닫습니다. 300~400자마다
##소제목으로 문단을 나누고, 핵심 키워드를**굵은 글씨**로 표시해 스크롤만 내려도 내용이 한눈에 들어오게 만듭니다.
- 줄글만 길게 이어지면 독자는 창을 닫습니다. 300~400자마다
- 비교표(Table) 또는 체크리스트 1개 이상 포함:
- 글 중간에 마크다운 표(
| 항목 | 내용 |)가 하나 들어가 있으면 독자의 체류 시간이 급격히 늘어나고, 구글과 AI 검색엔진이 해당 표를 검색 결과 상단에 바로 인용해 줍니다.
- 글 중간에 마크다운 표(
- 자주 묻는 질문 (
FAQ)으로 마무리:- 본문에서 다 다루지 못한 헷갈리는 질문 2~3가지를 문답 형식으로 정리해 글의 완성도를 높입니다.
5. 글을 다 썼다면? 10초 만에 인터넷에 발행하는 일상 루틴
글 작성이 끝났다면 키보드 **Ctrl + S**로 파일을 저장한 뒤, 터미널에 아래 세 줄을 입력(또는 AI 에이전트에게 *“새로 쓴 블로그 글 푸시해 줘”*라고 요청)합니다.
git add .
git commit -m "새 블로그 글 발행"
git push origin main
단 30초 뒤, 내 블로그 주소로 접속해 보면 방금 작성한 글이 목차(TOC)와 태그까지 자동으로 달려 예쁘게 올라와 있는 것을 확인하실 수 있습니다!
이제 마지막 **[4편]**에서는 이렇게 정성껏 쓴 내 글을 구글·네이버 검색창과 챗GPT·제미나이 같은 AI 검색엔진이 1순위로 찾아내게 만드는 SEO·GEO 비법과 구글 애드센스 수익화 방법을 알아보겠습니다.