시작하기
🚀

시작하기

파일을 고치거나 리포를 클론할 필요가 없습니다. 브라우저에서 끝납니다.

3단계

  1. Notion에서 사이트로 만들 페이지를 열고, 우상단 공유의 게시 탭에서 웹에 게시를 켭니다
  1. Vercel에 배포 버튼을 누르고 Notion 페이지 주소와 사이트 이름을 넣습니다
  1. 끝입니다. 이후 글은 Notion에서 고치면 10분 안에 반영됩니다
⚠️
배포 직후 "Notion 페이지가 공개되지 않았습니다" 화면이 뜨면 1번을 다시 확인하세요. 게시를 켜면 30초 안에 사이트로 바뀝니다.

준비물

  • GitHub 계정. Deploy 버튼이 여기에 새 리포를 만듭니다
  • Vercel 계정. 무료 플랜으로 됩니다
  • 웹에 게시한 Notion 페이지 하나
도메인은 준비물이 아닙니다. 없어도 배포되고, *.vercel.app 주소로 먼저 확인한 뒤 나중에 붙이면 됩니다.

자주 묻는 것

"웹에 게시"와 "링크 공유"가 다른 건가요
같은 공유 메뉴에 있지만 다른 설정입니다. 사이트가 읽는 쪽은 게시 탭의 웹에 게시입니다. 링크 공유만 켜면 사이트에서 페이지를 읽지 못해 "공개되지 않았습니다" 화면이 나옵니다.
Notion에서 고쳤는데 사이트가 그대로입니다
정상입니다. 본문은 10분 주기(ISR)로 다시 만들어집니다. 급하면 Vercel에서 재배포하면 즉시 반영됩니다.
도메인은 언제 붙이나요
배포가 끝난 뒤 아무 때나 붙입니다. Vercel 프로젝트의 Settings에서 Domains에 도메인을 넣으면 필요한 DNS 레코드를 알려줍니다.
도메인 값은 빌드 시점에 박히므로, 붙인 뒤 한 번 재배포해야 canonical URL과 공유 이미지가 새 주소를 가리킵니다. Cloudflare를 쓴다면 프록시를 꺼야 합니다.
/admin 설정 화면은 꼭 켜야 하나요
선택 기능이고 대부분 필요 없습니다. 기본값이 꺼짐이라 환경변수를 넣지 않으면 /admin은 404를 돌려줍니다.
설정을 바꿀 일이 생기면 site.config.ts를 고쳐 푸시하는 쪽이 더 간단합니다. 배포된 사이트에서 화면으로 고치고 싶을 때만 GitHub OAuth 앱을 등록하고 켜세요.
Vercel 무료 플랜으로 계속 쓸 수 있나요
Hobby 플랜은 비상업용입니다. 개인 블로그나 포트폴리오는 그대로 쓰면 되고, 수익이 붙는 사이트라면 요금제를 확인하세요.

🤖
코딩 에이전트에게 맡길 수도 있습니다. 리포에 AGENTS.md 플레이북이 있어서, 클론한 뒤 "내 Notion 페이지를 배포해줘"라고 하면 됩니다.