notion-doc

# Creating documents with Notion's design **This skill governs only how the document *looks*.** The outline, sections, and flow are decided by the content and the request — no particular document format (proposal, etc.) is imposed. Instead, every document is rendered with the blocks and design language Notion provides. ## 1. Header area (required) 1. **Page icon**: one emoji matching the document's topic, large, above the title (Notion page icon) 2. **Title**: a short noun phrase 3. **Meta line**: date · author · 1–2 tag pills 4. A thin divider below the meta line ## 2. Notion block dictionary — pick the block that fits the content | Content | Block | |---|---| | Key takeaway, the one line to emphasize | Callout (blue 💡) | | Reference, supplementary info | Callout (gray) | | Done, success, what went well | Callout (green ✅) | | Caution, constraints | Callout (yellow ⚠️) | | Warning, incident, risk | Callout (red 🚨) | | Opening of a long document (4+ h2s) | Table of contents (`toc`) | | Parent document, location context | breadcrumb | | Comparable, listable facts | simple table | | Two chunks that belong side by side | 2-column layout | | Long details or logs that break the flow | `<details>` toggle | | Tasks, progress | checkbox list (done items get strikethrough) | | Code | code block + `class="language-<lang>"` syntax highlighting (required) | | One striking sentence | quote (bold left bar) | | Introducing an external link | bookmark card | | A single call-to-action ...