[편집: 워크플로 다이어그램 삽입]
Notion으로 글을 쓰다 보면 목차와 내부링크가 뒤섞여 블로그로 옮길 때 수정 시간이 길어집니다. Astro 기반 정적 블로그는 마크다운 규칙을 미리 맞춰야 빌드 오류를 피할 수 있습니다. 전환 과정을 시스템화하면 작성자는 문서에 집중하고 에디터는 검수만으로도 배포를 끝낼 수 있습니다.
전환 준비 체크
Notion 템플릿에 제목, 설명, 발행일, 태그를 frontmatter와 동일한 필드로 구성합니다. 외부 링크는 각주로, 내부 링크 후보는 [[큐레이션]]처럼 이중 대괄호로 표시해 추출을 단순화합니다. [편집: 템플릿 스크린샷 지정]
목차 구조 맞추기
Heading 2는 본문 주요 섹션, Heading 3은 세부 절차만 배치하고 그 이하 레벨은 블로그에 옮기지 않습니다. 목차 자동 생성 플러그인을 사용한다면 제목 앞 숫자나 이모지를 제거해 URL 슬러그 충돌을 막습니다. 에디터는 전환 시 toc: true 여부를 확인해 목차 삽입 위치를 고정합니다.
내부링크 전략
Notion에서 [[ 형식으로 표시한 내부 링크는 Astro로 옮길 때 /blog/{slug}/ 패턴으로 일괄 치환합니다. 동일 카테고리에서는 두 개 이상의 시리즈 글을 연결하고, KPI 게시물에는 Evergreen 글을 우선 링크합니다. 신규 글이 많을 땐 업데이트 로그를 만들어 6개월 점검 대상에서 누락되지 않도록 관리합니다.
요약 및 FAQ
- Notion 템플릿을 frontmatter와 동일한 필드로 구성
- H2/H3만 블로그 목차에 사용해 계층을 단순화
- 내부 링크는 슬러그 패턴으로 치환하고 Evergreen 우선 연결
Q1. Notion 목차 블록은 그대로 가져와도 되나요?
A1. 목차 블록은 HTML로 출력돼 레이아웃을 깨뜨릴 수 있으니 삭제 후 Astro에서 자동 생성하는 것이 안전합니다.
Q2. 내부 링크 슬러그가 나중에 바뀌면 어떻게 하나요?
A2. 변경 시 리디렉션을 준비하고 전환 스프레드시트에서 링크 쌍을 관리하면 대량 수정 부담을 줄일 수 있습니다.