Markdown 기반 블로그의 장단점

카테고리: 블로그 자동화 #Markdown#정적 블로그#Astro#블로그 운영

정적 블로그를 만들면 글을 Markdown 파일로 관리하는 경우가 많습니다.
이 방식은 WordPress나 Tistory처럼 관리자 화면에서 글을 쓰는 방식과 꽤 다릅니다.

처음에는 낯설지만, 여러 블로그를 장기적으로 운영하려면 장점도 분명합니다.

Markdown 블로그의 장점

1. 글이 파일로 남는다

Markdown 블로그에서는 글 하나가 파일 하나입니다.

예를 들면 이런 식입니다.

src/content/blog/markdown-blog-pros-cons.md

글이 플랫폼 안에만 갇히지 않고 내 컴퓨터와 GitHub에 남습니다.

2. 백업과 버전 관리가 쉽다

Git으로 관리하면 언제 어떤 글을 수정했는지 기록이 남습니다.

실수로 문단을 지워도 이전 커밋에서 되돌릴 수 있습니다.

수익형 블로그를 여러 개 운영할 때는 이 점이 꽤 중요합니다.

3. 디자인과 구조를 마음대로 바꿀 수 있다

관리형 블로그는 제공되는 스킨이나 플러그인에 의존합니다.

반면 Markdown 기반 정적 블로그는 HTML, CSS, 컴포넌트를 직접 바꿀 수 있습니다.

처음에는 손이 더 가지만, 나중에는 블로그마다 구조를 복제하기 좋습니다.

4. 속도가 빠르고 보안 부담이 적다

정적 블로그는 서버에서 매번 페이지를 만드는 방식이 아닙니다.

미리 만들어진 HTML을 제공하므로 빠르고, 로그인 관리자 페이지가 없어 공격면도 적습니다.

Cloudflare Pages 같은 서비스와 잘 맞는 이유입니다.

Markdown 블로그의 단점

1. 처음 진입 장벽이 있다

관리자 화면에서 글 쓰는 방식에 익숙하면 처음에는 불편합니다.

파일 경로, frontmatter, Git, 배포 흐름을 알아야 합니다.

2. 모바일에서 바로 쓰기 어렵다

Tistory나 WordPress 앱처럼 휴대폰에서 바로 글을 쓰는 경험은 약합니다.

대신 Obsidian이나 메모앱에 초안을 적고, 나중에 Markdown으로 옮기는 방식이 현실적입니다.

3. 이미지 관리가 번거로울 수 있다

글이 많아지면 이미지 파일 위치와 이름 규칙이 필요합니다.

처음부터 대충 넣으면 나중에 정리하기 어렵습니다.

예를 들면 이런 규칙을 둘 수 있습니다.

public/images/blog/글-slug/이미지명.webp

4. 예약 발행이나 댓글은 직접 붙여야 한다

정적 블로그는 기본적으로 단순합니다.

예약 발행, 댓글, 검색, 뉴스레터 같은 기능은 별도로 붙여야 합니다.

처음에는 기능을 줄이고 글 발행에 집중하는 편이 낫습니다.

여러 블로그 운영에는 잘 맞는가?

개인적으로는 3~5개 블로그를 장기적으로 운영하려면 Markdown 방식이 괜찮다고 봅니다.

이유는 단순합니다.

  • 복제하기 쉽다.
  • 비용이 낮다.
  • 글과 코드가 내 소유로 남는다.
  • 자동화하기 좋다.
  • 플랫폼 변경에 덜 휘둘린다.

다만 초반에는 너무 많은 자동화를 붙이지 않는 것이 좋습니다.

먼저 한 개 블로그에서 글 작성, 배포, Search Console 등록까지 흐름을 익힌 뒤 복제하는 편이 안전합니다.

Daejin Lab에서 실제로 쓰는 글 파일 구조

현재 Daejin Lab의 글은 아래 폴더에 Markdown 파일로 들어갑니다.

src/content/blog/

예를 들면 이런 파일들이 있습니다.

astro-cloudflare-static-blog.md
api-key-safe-management.md
markdown-blog-pros-cons.md

각 글에는 제목, 설명, 작성일, 카테고리, 태그가 들어갑니다.

title
description
pubDate
category
tags
draft

이 구조 덕분에 글 목록, 카테고리 페이지, sitemap이 자동으로 만들어집니다. 관리자 화면은 없지만, 파일 규칙만 지키면 블로그 전체 구조가 비교적 단순하게 유지됩니다.

실제로 불편했던 점

Markdown 방식이 무조건 편한 것은 아닙니다.

이번 작업에서도 불편한 점이 있었습니다.

  • 글을 쓴 뒤 바로 공개되는 것이 아니라 빌드와 배포를 거쳐야 합니다.
  • frontmatter 형식이 틀리면 빌드에서 문제가 날 수 있습니다.
  • 이미지가 늘어나면 별도 규칙이 필요합니다.
  • 휴대폰에서 바로 수정하기는 어렵습니다.

그래도 이 불편함은 운영 규칙으로 어느 정도 줄일 수 있습니다.

글 파일 이름은 영어 slug로 쓴다.
카테고리는 정해진 값만 쓴다.
수정 후 npm run build를 실행한다.
배포 후 공개 URL을 확인한다.

5개 블로그로 확장할 때의 장점

Markdown 기반 구조는 1호 블로그에서 검증한 구조를 다른 블로그에 복제하기 좋습니다.

예를 들어 나중에 전기차 블로그나 맛집 블로그를 만들 때도 기본 구조는 거의 같습니다.

Astro 프로젝트
src/content/blog
카테고리 메타데이터
소개/문의/개인정보/광고고지
Cloudflare Pages 배포
Search Console 등록

달라지는 것은 디자인보다 주제, 카테고리, 글 작성 기준입니다. 그래서 1호 블로그에서 운영 흐름을 먼저 안정화하는 것이 중요합니다.

결론

Markdown 기반 블로그는 처음에는 조금 개발자스럽고 불편합니다.
하지만 장기 운영, 백업, 자동화, 다중 블로그 확장에는 강점이 있습니다.

Daejin Lab도 이 방식을 먼저 선택한 이유는 서버 관리보다 글과 실험 기록에 집중하기 위해서입니다. 앞으로 여러 블로그를 운영한다면, 이 구조가 반복 가능한 기본 템플릿이 될 수 있습니다.