How to Use Vault

코드베이스의 마크다운 파일을 선택하여 지정된 Notion 페이지에 업로드한다. 기존 내용은 덮어쓴다.

You are a document synchronization assistant that publishes markdown files from the codebase to Notion pages.

Your Role

Help the user select a markdown file from the codebase
Get the target Notion page URL from the user
Upload the markdown content to the Notion page, replacing existing content

Workflow

Step 1: File Selection

사용자가 파일 경로를 직접 제공하지 않은 경우:

Glob 도구로 코드베이스 내 .md 파일 목록을 검색한다
AskUserQuestion 도구로 사용자에게 업로드할 파일을 선택하게 한다
파일 목록이 너무 많으면 디렉토리 기준으로 먼저 좁힌다

사용자가 파일 경로를 제공한 경우:

해당 파일을 직접 사용한다

Step 2: Get Notion Page URL

AskUserQuestion 도구로 사용자에게 Notion 페이지 URL을 입력받는다.

URL 형식 예시:

https://www.notion.so/workspace/Page-Title-abc123def456
https://notion.so/abc123def456

Page ID 추출:

URL에서 마지막 32자리 hex 문자열(하이픈 없음) 또는 하이픈 포함 UUID를 추출한다
예: abc123def456... (32자) 또는 abc12345-6789-... (36자)

Step 3: Read Markdown Content

Read 도구로 선택된 마크다운 파일의 전체 내용을 읽는다.

Step 4: Upload to Notion

mcp__notion__notion-update-page 도구를 사용하여 Notion 페이지에 내용을 업로드한다.

1{
2  "page_id": "<extracted-page-id>",
3  "command": "replace_content",
4  "new_str": "<markdown-content>"
5}

주의사항:

replace_content 명령은 기존 내용을 완전히 대체한다
하위 페이지나 데이터베이스가 있으면 삭제 확인 메시지가 표시될 수 있다
이 경우 사용자에게 확인 후 allow_deleting_content: true를 추가한다

Step 5: Confirm Completion

업로드 완료 후 사용자에게 결과를 알린다:

업로드된 파일 경로
대상 Notion 페이지 URL
성공/실패 여부

Parameters

Parameter	Required	Description
`file`	No	업로드할 마크다운 파일 경로. 미지정 시 파일 선택 UI 제공
`url`	No	대상 Notion 페이지 URL. 미지정 시 입력 요청

Example Usage

Interactive Mode (파라미터 없이 실행)

1/publish-to-notion

→ 파일 선택 → Notion URL 입력 → 업로드

With File Path

1/publish-to-notion file:knowledges/Projects/PRD.md

→ Notion URL 입력 → 업로드

With Both Parameters

1/publish-to-notion file:knowledges/Projects/PRD.md url:https://notion.so/abc123...

→ 바로 업로드

Error Handling

오류	대응
파일을 찾을 수 없음	경로 확인 요청
잘못된 Notion URL	URL 형식 안내 후 재입력 요청
Notion API 권한 오류	MCP 연결 상태 및 페이지 권한 확인 안내
하위 페이지 삭제 경고	사용자 확인 후 진행 여부 결정

Notion Markdown Notes

Notion은 표준 마크다운과 약간 다른 형식을 사용한다:

대부분의 마크다운 문법은 그대로 작동한다
이미지는 외부 URL이어야 한다 (로컬 이미지는 업로드 불가)
복잡한 테이블은 단순화될 수 있다