**Step 1: 读取并分析原始内容** 1. 使用 read 工具读取用户提供的文档内容（如果用户通过 @引用提供） 2. 如果用户直接在对话中提供文本，直接使用该文本 3. 分析内容的类型和结构： - 识别标题层级 - 识别列表、代码块、引用块 - 识别关键信息点（重点、注意事项、提示等） - 识别可以折叠的长段落或详细说明 4. 确认内容已完整获取后，进入下一步

**Step 2: 优化标题层级结构** 按照 Notion 最佳实践优化标题： 1. 确保文档有清晰的 H1 主标题（# 标题） 2. 使用 H2（## 标题）作为主要章节 3. 使用 H3（### 标题）作为子章节 4. 避免跳级（如从 H1 直接到 H3） 5. 为没有标题的段落组添加合适的标题 6. 标题应简洁明确，体现内容要点 注意：保持原有内容的逻辑结构，只优化层级表达

**Step 3: 添加 Callout 提示框** 识别并转换关键信息为 Notion Callout 格式： **Callout 语法：** ``` > 💡 **提示** > 这里是提示内容 ``` **应用场景：** 1. **💡 提示/Tip**：有用的建议、技巧 2. **⚠️ 注意/Warning**：需要注意的事项、警告 3. **✅ 重点/Important**：核心要点、关键信息 4. **📌 说明/Note**：补充说明、背景信息 5. **❓ 问题/Question**：待解决的问题、思考点 6. **🎯 目标/Goal**：目标、期望结果 7. **💻 代码说明/Code Note**：代码相关的重要说明 识别原文中适合转换为 Callout 的内容并添加合适的图标和标题

**Step 4: 使用 Toggle 折叠列表优化长内容** **Toggle 语法：** ```

点击展开：标题

这里是折叠的内容 可以是多段文字、列表、代码等

``` **应用场景：** 1. 详细的技术说明或步骤 2. 补充资料和参考信息 3. 示例代码和详细解释 4. FAQ 问答 5. 长列表或详细清单 将适合折叠的内容转换为 Toggle 格式，保持主文档简洁，同时保留详细信息的可访问性

**Step 5: 优化列表和表格** **列表优化：** 1. 使用无序列表（-）表达并列关系 2. 使用有序列表（1. 2. 3.）表达步骤或优先级 3. 使用任务列表（- [ ] 和 - [x]）表达待办事项 4. 确保列表层级清晰（使用 2 空格缩进） 5. 列表项保持简洁，复杂内容考虑拆分或使用 Toggle **表格优化：** 1. 确保表格格式正确对齐 2. 表头使用粗体或清晰的标识 3. 复杂数据考虑添加说明 4. 表格前添加简短的说明文字 示例： ```markdown | 功能 | 说明 | 状态 | |------|------|------| | 功能A | 描述 | ✅ 完成 | | 功能B | 描述 | 🔄 进行中 | ```

**Step 6: 优化代码块和引用** **代码块优化：** 1. 确保所有代码使用正确的语言标识 ```python # 示例 print('Hello') ``` 2. 为代码块添加简短说明 3. 行内代码使用 `code` 格式 **引用块优化：** 1. 重要引用保持 > 引用格式 2. 或转换为 Callout 格式以增强视觉效果 **链接优化：** 1. 使用描述性链接文本：[查看文档](url) 而不是 [点击这里](url) 2. 重要链接可以单独成行并添加说明

**Step 7: 增强可读性和视觉层次** 1. **段落优化：** - 确保段落之间有适当的空行 - 长段落考虑拆分为多个短段落 - 每段聚焦一个主题 2. **强调和格式：** - 使用 **粗体** 强调关键词 - 使用 *斜体* 表达术语或引用 - 适当使用 `行内代码` 标识技术术语 3. **视觉分隔：** - 使用 `---` 水平线分隔大章节 - 使用空行创建视觉呼吸空间 4. **emoji 使用：** - 在标题或 Callout 中适度使用 emoji 增强可读性 - 不要过度使用，保持专业性

**Step 8: 生成优化后的文档** 1. 使用 write 工具创建新文档，包含优化后的内容 2. 文档标题格式：「原标题 - Notion 优化版」 3. 在文档开头添加一个简短说明： ```markdown > 📝 **文档说明** > 本文档已按照 Notion 格式规范进行优化，包含： > - ✅ 标题层级优化 > - ✅ Callout 提示框 > - ✅ Toggle 折叠列表 > - ✅ 格式化的列表和表格 > - ✅ 增强的可读性 --- ``` 4. 然后是优化后的完整内容 5. 告知用户文档已创建完成，可以直接复制到 Notion 使用

**Step 9: 提供使用指导** 向用户说明： 1. 优化后的文档已创建完成 2. 可以直接复制内容到 Notion 3. Notion 中的显示效果说明： - Callout 会显示为彩色提示框 - Toggle 会显示为可折叠的内容块 - 代码块会有语法高亮 4. 如果有任何需要调整的地方，可以告诉你进行修改 5. 询问用户是否需要进一步优化或调整某些部分