Notion — Content Launcher (콘텐츠 런처)
Notion 개요 — Notion 위키 발행 노션 \ \ 데이터베이스(DB)\ \ 에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다. 발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대
핵심 요약
# Notion
개요 — Notion 위키 발행
노션 \*\*데이터베이스(DB)\*\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.
발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대상 DB를 통합에 연결(공유) ③ database\_id. 아래 \[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.
필수 필드 — 필수 필드
- notion\_token — 통합 시크릿.
ntn_또는secret_로 시작합니다. - database\_id — 발행 대상 노션 데이터베이스 ID(32자리).
- category\_prop (선택) — 카테고리를 기록할 DB 속성명(예:
분류,태그).
토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인
1) 통합 토큰 발급
- https://www.notion.so/my-integrations 접속 (또는 노션 좌하단 설정 → Connections → 통합 개발/관리)
- 기존 통합 선택, 또는 + New integration으로 생성(워크스페이스 선택, Capabilities에 Read content + Insert content 체크)
- Configuration 탭 → Internal Integration Secret → Show → Copy →
notion_token에 입력 (ntn_…)
2) 통합을 대상 DB에 연결(공유) — 필수
> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 404가 납니다.
- 발행할 데이터베이스를 full page로 열기
- 우측 상단 ···(More) → Connections(연결) → 위에서 만든 통합 선택해 추가
3) database\_id 확인 (URL에서)
- 데이터베이스를 full page로 연 상태의 주소창 URL:
https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID} ?v=바로 앞 32자리가 database\_id 입니다(대시 없어도 됨).- ⚠️ URL에
?v=가 있어야 데이터베이스입니다. 없으면 _페이지_ ID라 발행이 안 됩니다. - 인라인 데이터베이스는 제목 옆 ⤢(open as full page) 로 펼친 뒤 URL을 확인하세요.
4) 입력 · 확인
- 연결 정보 탭에
notion_token·database_id· (선택)category_prop입력 → 저장. - 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.
자주 발생하는 오류 — 자주 발생하는 오류
- 404 object\_not\_found / Could not find database — 통합이 그 DB에 공유되지 않음(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의
?v=확인). - 401 unauthorized / API token is invalid — 토큰 오류·만료. my-integrations에서 시크릿 재확인.
- category\_prop이 반영 안 됨 — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.
권장 사항 — 권장 사항
- 데이터베이스 ID를 사용하세요(페이지 ID 아님) — URL의
?v=앞 32자리. - 통합 Capabilities에 Insert content 포함.
- 노션 위키는 대표(특성)이미지·CTA를 사용하지 않고, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.