📝 Notion To Github Template

Notion 데이터베이스에 작성한 글을 매일 자동으로 GitHub 리포지토리에 백업하고, README에 목록을 업데이트해주는 자동화 템플릿입니다.

🚀 기능

• 자동 백업: 매일 자정(KST 00:05), 어제 작성한 노션 글을 Markdown 파일로 저장합니다.
• 월별 정리: TIL/2026/01 처럼 연/월별 폴더로 자동 정리됩니다.
• README 갱신: 최근 달의 글은 목록으로 보여주고, 지난달 글은 접기(Toggle)로 깔끔하게 정리합니다.

🛠 사용 방법 (Setup)

1. 이 저장소 사용하기

우측 상단의 Use this template 버튼을 누르거나 Fork 하여 자신의 리포지토리로 가져갑니다.

2. Notion 설정

1. Notion Developers에서 새 통합(Integration)을 만들고 Internal Integration Token을 복사합니다.
2. Notion 데이터베이스 페이지 우측 상단 ... -> 연결(Connect) -> 위에서 만든 통합을 추가합니다.
3. 데이터베이스의 링크를 복사하여 ID를 확보합니다. (URL 중 ? 앞부분의 32자리 숫자+영문)
4. 필수: 데이터베이스 속성(컬럼) 이름이 제목과 날짜여야 합니다. (다를 경우 update_readme.py 상단 변수 수정 필요)

3. GitHub Secrets 등록

리포지토리의 Settings > Secrets and variables > Actions > New repository secret 클릭:

• NOTION_TOKEN: 위에서 복사한 노션 통합 토큰
• NOTION_DATABASE_ID: 노션 데이터베이스 ID

4. 권한 설정

Settings > Actions > General > Workflow permissions 에서:

• ✅ Read and write permissions 선택 후 Save.

5. 적용 확인

Actions 탭에서 워크플로우를 수동 실행(Run workflow) 해보거나, 다음날 자동 실행을 기다립니다.

6. 비고

추가로 시간 셋팅을 위한 GUIDE Docs 🕒 시간 설정 가이드 보러가기 에서 확인하시길 바랍니다.

---

🧑‍💻 나의 개발 블로그

안녕하세요! 매일 Notion에 글을 씁니다.