notion-writelisted

# notion-write — 노션 페이지 가독성 스타일 가이드 노션 MCP(`notion-create-pages` / `notion-update-page`)로 페이지 본문을 만들 때, **읽는 사람이 스캔으로 요지를 잡을 수 있는 구조**로 쓰게 하는 규칙이다. ## 왜 필요한가 (전제) 사람은 문서를 **읽지 않고 스캔**한다. 스캔 사용자는 페이지 앞 1/4만 훑고, 시선은 좌측 세로 라인(F-패턴)을 따른다. 그래서 "긴 문단이 소제목·강조·구획 없이 이어지는 텍스트 벽"은 정보가 다 있어도 **안 읽힌다**. AI가 만든 노션 페이지가 "형편없다"는 건 내용이 부족해서가 아니라, 이 스캔 구조를 안 만들어서다. 노션 MCP는 기본 마크다운만 쓰는 게 아니라 **콜아웃·토글·컬럼·색·표·목차 같은 네이티브 블록을 전부 생성할 수 있다**(문법은 `references/block-cheatsheet.md`). 이 스킬의 본질은 "**언제 어떤 블록을 쓸지**"를 못박아, 매번 재설계 없이 일관되게 스캔 가능한 페이지를 뽑는 것이다. > **문법 스펙은 MCP가 직접 제공한다.** 페이지를 쓰기 전 MCP 리소스 `notion://docs/enhanced-markdown-spec`을 (resource-reading 인터페이스로) 읽어 정확한 Notion-flavored Markdown 문법을 확인한다. 이 스킬은 그 위에 얹는 **판단 규칙**이다. --- ## 언제 적용하나 - **적용**: 노션에 새 페이지/문서 본문을 작성할 때 — 보고서·가이드·매뉴얼·위키·회의록·기획·정리 노트 등. - **특화 스킬과의 관계**: 회의록 생성처럼 전용 워크플로우 스킬이 따로 있으면 그 절차를 우선하되, **본문 블록 구성은 이 규칙을 함께 적용**한다. - **범위**: 새 페이지 생성이 중심이다. 기존 페이지를 통째로 재구조화(`replace_content`)하는 건 자식 페이지 삭제 위험이 있어 이 스킬의 기본 범위가 아니다 — 요청 시 사용자에게 위험을 알리고 확인받는다. --- ## 페이지 작성 워크플로우 순서대로 세운다: **진입부(식별·맥락·내비) → 본문 골격 → 블록 선택 → 강조 규율 → 생성 후 검증.** ### 1) 진입부 — 본문 시작 전에 "무엇/누구·언제/어디로"를 해결 읽는 사람이 첫 화면에서 이 문서가 뭔지 알아야 한다. 위에서부터: 1. **페이지 아이콘(이모지)** 을 설정한다(`icon` 파라미터). 사이드바·검색에서 문서를 식별하는 시각 앵커. 2. 제목 바로 아래 **요약 콜아웃** 하나. 이 문서가 무엇인지 / 핵심 결론 / (해당 시) 담당·날짜를 1~3줄로. 결론을 먼저 놓는다(역피라미드). - 문서형(가이드·위키): `<callout icon="📋" color="gray_bg">` 로 "이 문서란 / 왜" - 경고·주의가 핵심이면: `color="red_bg"`(경고) / `yellow_bg`(주의·팁) 3. 헤딩이 5개 이상인 긴 문서면 요약 아래 **`<ta