피드로 돌아가기
Dev.toFrontend
원문 읽기
Substack 탈피를 통한 SEO 제어권 확보 및 Custom Renderer 기반의 고밀도 독서 경험 구현
How we run our newsletter on our own Astro stack instead of Substack
AI 요약
Context
Substack의 폐쇄적인 아키텍처로 인한 sitemap, canonical tag 설정 불가 및 도메인 제어권 부재로 SEO 최적화에 한계 직면. 인덱싱 변수 제거와 완전한 기술적 제어권을 확보하기 위해 자체 스택으로의 전환 결정.
Technical Solution
- Astro 기반 Static Site Generation(SSG)을 도입하여 CMS와 Database 없는 빌드 타임 렌더링 구조 설계
- Git history의 mtime을 추출하여 sitemap의 lastmod를 동적으로 할당함으로써 검색 엔진에 정확한 업데이트 시점 전달
- Markdown frontmatter 데이터를 JSON-LD로 자동 컴파일하여 수동 작업 없는 구조화 데이터(Structured Data) 최적화
- raw-markdown twin 경로(/blog/.md)를 제공하여 LLM 및 스크립트의 효율적인 데이터 파싱 지원
- Resend API 기반의 Node script를 통한 캠페인 발송 및 PostHog 1x1 Tracking Pixel과 302 Redirector로 자체 분석 파이프라인 구축
- Custom CSS 및 Renderer 제어를 통해 Sidenotes 및 정교한 Typography 시스템 구현
실천 포인트
- SEO 최적화를 위해 sitemap의 lastmod를 단순 빌드 시간이 아닌 Git 커밋 로그 기반으로 설정하는 방안 검토 - LLM 친화적 콘텐츠 제공을 위해 HTML 외에 Raw Markdown 접근 경로를 별도로 생성하는 구조 적용 - 분석 툴 의존도를 낮추기 위해 단순한 1x1 픽셀 엔드포인트와 리다이렉트 서버를 통한 이벤트 캡처 로직 설계 - 구조화 데이터(JSON-LD) 작성을 자동화하기 위해 Content Collection의 metadata를 활용하는 파이프라인 구축