Notion 페이지를 이메일 뉴스레터로? 무료 오픈소스 'notion-to-email' 써봤습니다

뉴스레터를 만들어보고 싶었지만, Mailchimp나 Substack 같은 도구의 유료 플랜 앞에서 주저했던 적 있으신가요? 저도 그랬습니다. 구독자가 적은 초반에는 특히, "돈 내고 이걸 시작해야 하나?" 싶은 마음이 먼저 들죠.

그런데 최근 해외 개발자 커뮤니티에서 흥미로운 프로젝트 하나가 올라왔습니다. notion-to-email이라는 오픈소스 라이브러리인데, 이름 그대로 Notion 페이지를 이메일용 HTML로 변환해주는 도구입니다. Notion에서 글만 쓰면, 나머지는 알아서 처리해준다는 콘셉트죠.

이게 정말 무료라고? 직접 써봤습니다.

이런 분들에게 딱 맞습니다

notion-to-email을 쓰면 가장 이득을 보는 케이스부터 정리해봤습니다.

첫째, 이미 Notion으로 글을 쓰고 있는 분. 별도의 에디터를 배울 필요 없이, 익숙한 Notion 환경에서 작성한 내용을 그대로 뉴스레터로 내보낼 수 있습니다. 전환 비용이 거의 없습니다.

둘째, 뉴스레터를 직접 자체 발송하고 싶은 분. AWS SES, Resend, Postmark 같은 저렴한 이메일 발송 서비스를 이미 쓰고 있다면, HTML 템플릿을 직접 만드는 수고를 이 라이브러리가 대신해줍니다.

셋째, 개발자이거나 자동화에 관심 있는 분. Node.js 기반이라 기존 자동화 파이프라인에 붙이기 쉽습니다. Notion API와 연동하면 "글 작성 → 자동 변환 → 발송"까지 완전 자동화가 가능합니다.

핵심 기능 3가지

첫째, Notion 블록을 이메일 안전 HTML로 변환합니다. 이메일 HTML은 일반 웹 HTML과 다릅니다. Gmail, Outlook, Apple Mail 등 수십 가지 클라이언트에서 깨지지 않으려면 테이블 레이아웃, 인라인 스타일, 특정 태그 제한 등을 지켜야 합니다. notion-to-email은 이 까다로운 규칙을 내부적으로 처리해서 어느 클라이언트에서도 잘 보이는 HTML을 만들어줍니다. 텍스트, 제목, 불릿 리스트, 번호 목록, 인용구, 코드 블록, 구분선까지 대부분의 Notion 블록 타입을 지원합니다.

둘째, 이미지와 링크를 그대로 유지합니다. Notion 페이지에 삽입한 이미지 URL과 하이퍼링크가 변환 후에도 그대로 살아납니다. 이미지가 사라지거나 링크가 깨지는 일이 없어서, 완성된 뉴스레터를 그대로 발송할 수 있습니다.

셋째, 완전한 오픈소스로 커스터마이징이 자유롭습니다. 라이선스 걱정 없이 상업적으로도 쓸 수 있고, 스타일을 직접 수정하거나 기능을 추가하는 것도 자유입니다. 회사 브랜드 컬러에 맞게 템플릿을 바꾸거나, 헤더·푸터를 추가하는 것도 코드 몇 줄이면 됩니다.

설치 및 사용법 (5분이면 충분합니다)

Node.js가 설치된 환경이라면 바로 시작할 수 있습니다. 터미널을 열고 아래 명령어를 입력하세요.

npm install notion-to-email

설치가 끝나면 Notion API 키가 필요합니다. Notion 계정이 있다면 아래 순서로 발급받을 수 있습니다.

1. Notion Integrations 페이지로 이동합니다 (notion.so/my-integrations).
2. "New integration" 버튼을 눌러 새 통합을 만듭니다.
3. 이름을 입력하고(예: my-newsletter) 저장하면 Internal Integration Token이 발급됩니다.
4. 변환할 Notion 페이지로 이동해서 오른쪽 상단 "..." 메뉴 → "Connections" → 방금 만든 통합을 연결합니다.
5. 페이지 URL에서 마지막 32자리 문자열이 Page ID입니다.

준비가 됐으면 아래처럼 코드를 작성합니다.

import { notionToEmail } from 'notion-to-email';

const html = await notionToEmail({
  notionToken: 'your_integration_token',
  pageId: 'your_page_id',
});

// html에 이메일 발송용 HTML 문자열이 담깁니다
console.log(html);

이게 전부입니다. 복잡한 설정이 없습니다. html 변수에 담긴 결과물을 AWS SES나 Resend 같은 발송 서비스에 바로 넣으면 뉴스레터가 완성됩니다.

실제로 써보니 이런 점이 좋았습니다

직접 Notion 페이지에 뉴스레터 초안을 작성하고 변환해봤습니다. 솔직한 사용 후기를 정리해봤습니다.

작성 경험이 매우 편합니다. Notion의 슬래시(/) 명령어로 블록을 넣고, 드래그로 순서를 바꾸고, 토글로 내용을 접는 것, 이 익숙한 작업 방식이 그대로 유지됩니다. Mailchimp의 드래그앤드롭 에디터보다 오히려 더 자유롭게 글이 써집니다.

결과 HTML의 완성도가 기대 이상입니다. Gmail과 Apple Mail에서 테스트해봤는데, 이미지 정렬이나 텍스트 스타일이 잘 유지됐습니다. 직접 손으로 이메일 HTML을 짜는 것과 비교하면 엄청난 시간 절약입니다. 이메일 HTML을 처음부터 만드는 것은 생각보다 훨씬 번거로운 작업이거든요.

자동화와 궁합이 좋습니다. 저는 테스트 삼아 Notion 데이터베이스에 "발행 예정" 상태의 글이 올라오면 자동으로 변환 후 발송하는 간단한 스크립트를 만들어봤습니다. 전체 코드가 50줄도 안 됐습니다. 매주 수동으로 복사-붙여넣기 하던 작업이 완전히 사라지는 느낌이었습니다.

아쉬운 점도 있습니다. 현재 버전 기준으로 Notion의 데이터베이스 뷰나 캘린더, 임베드 블록은 지원하지 않습니다. 뉴스레터에 일반적으로 쓰이는 텍스트·이미지·링크 중심 콘텐츠라면 문제없지만, 복잡한 레이아웃을 기대하면 한계가 있습니다. 오픈소스이니 직접 기여해서 기능을 추가하는 것도 방법입니다.

비슷한 대안과 비교해보면

같은 문제를 해결하는 다른 방법들과 비교해봤습니다.

Mailchimp / Stibee 같은 뉴스레터 플랫폼: 구독자 관리, 발송 통계, 스팸 필터 등 완성된 기능을 제공합니다. 다만 구독자가 늘면 비용이 올라가고, Notion 외부에서 글을 따로 써야 합니다. 처음 시작하거나 구독자 수가 많지 않다면 notion-to-email + 저렴한 발송 서비스 조합이 훨씬 경제적입니다.

Notion2Sheets, super.so 같은 Notion 연동 서비스: 이쪽은 Notion을 웹사이트나 스프레드시트로 내보내는 데 특화되어 있습니다. 이메일 HTML로의 변환은 지원하지 않거나 별도 작업이 필요합니다.

직접 HTML 코딩: 자유도는 최고지만, 이메일 HTML의 특수성 때문에 숙련된 개발자도 시간이 많이 걸립니다. 매번 클라이언트 호환성을 테스트해야 하는 번거로움도 있습니다.

결론적으로 notion-to-email은 "Notion을 이미 쓰고 있고, 뉴스레터 발송을 자체적으로 관리하고 싶은 사람"에게 최적의 선택입니다. 비용 부담 없이 시작할 수 있고, 익숙한 환경에서 글을 쓸 수 있으며, 자동화 가능성도 열려 있습니다.

뉴스레터 발송 비용 때문에 시작을 미뤄왔다면, 오늘 한번 설치해보시길 권합니다. npm install 한 줄이면 바로 시작할 수 있습니다.