PROJECTSPARTNERSCONTACTS
© 2025 MECH2CS. All rights reserved.
개인정보처리방침이용약관

Notion API 기반 static HTML 생성기

Notion 페이지를 고성능 정적 HTML로 변환하는 생성 엔진

2022년 기준, Notion 페이지를 모바일 Webview에서 직접 로딩할 때 발생하는 최대 16초의 딜레이 문제를 해결하기 위해 개발되었습니다. Notion API를 분석하여 클라이언트 사이드 렌더링 대신 빌드 타임에 완전한 정적 HTML을 생성하는 아키텍처를 제안하고 구현했습니다. 기존 Notion Export에서는 임베드(PDF, 지도, YouTube)가 제대로 표현되지 않거나 레이아웃이 깨지는 현상이 발생하여, 이를 해결하기 위해 독자적인 파싱 엔진을 개발했습니다.

Notion HTML Generator 1
Notion HTML Generator 3
Notion HTML Generator 4
Notion HTML Generator 1
Notion HTML Generator 3
Notion HTML Generator 4
개발 기간:약 3주
담당 역할:기술 제안, 설계, 핵심 로직 구현

주요 역할

성능 최적화 및 아키텍처 설계

  • Notion API 기반의 Static Site Generation(SSG) 파이프라인 설계
  • Webview 로딩 시간을 16초에서 1초 미만으로 단축하여 사용자 경험 획기적 개선

렌더링 엔진 개발

  • Notion Block 데이터를 HTML로 변환하는 커스텀 파서 개발
  • 비디오, 파일 첨부, 임베드 링크 등 복잡한 블록 타입에 대한 완벽한 렌더링 지원

기술 스택

Node.js, Notion API, HTML/CSS, TypeScript