notion-integration
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseNotion Integration
Notion 集成
Full Notion workspace access for reading, writing, and organizing content.
完全访问Notion工作区，可进行内容的读取、写入与整理。
When to Use
使用场景
- User mentions Notion, pages, databases, or workspace
- User wants to create or update documentation
- User needs to search their knowledge base
- User wants to sync Notion content to local files
- 用户提及Notion、页面、数据库或工作区
- 用户想要创建或更新文档
- 用户需要搜索其知识库
- 用户想要将Notion内容同步到本地文件
Procedure
操作流程
- Verify Notion API key is configured
- Search or navigate to the target page/database
- Perform the requested operation (read/write/update)
- Format output for readability
- Confirm changes were applied
- 确认已配置Notion API密钥
- 搜索或导航至目标页面/数据库
- 执行请求的操作（读取/写入/更新）
- 格式化输出以提升可读性
- 确认更改已生效
Operations
操作功能
Search
搜索
- Search pages: Query by title or content
- List databases: Show all accessible databases
- Filter database: Query with filters and sorts
- 搜索页面：按标题或内容查询
- 列出数据库：显示所有可访问的数据库
- 筛选数据库：使用筛选条件和排序规则查询
Pages
页面
- Read page: Extract full content with formatting
- Create page: Build from markdown or structured input
- Update page: Modify blocks, properties, or content
- Archive page: Soft-delete by archiving
- 读取页面：提取带格式的完整内容
- 创建页面：从markdown或结构化输入生成
- 更新页面：修改块、属性或内容
- 归档页面：通过归档进行软删除
Databases
数据库
- Query: Filter, sort, and paginate results
- Create entry: Add new row with properties
- Update entry: Modify specific properties
- 查询：筛选、排序并分页显示结果
- 创建条目：添加带属性的新行
- 更新条目：修改特定属性
Pitfalls
注意事项
- Notion API has rate limits (3 requests/second)
- Page content is returned as blocks — reassemble for readability
- Integration must be shared with target pages
- Rich text formatting may not convert perfectly to markdown
- Notion API有速率限制（3次请求/秒）
- 页面内容以块的形式返回——需重新组装以提升可读性
- 集成必须与目标页面共享
- 富文本格式可能无法完美转换为markdown
Verification
验证
- Confirm page exists and content matches
- Verify database entries have correct properties
- Check that shared pages are accessible
- 确认页面存在且内容匹配
- 验证数据库条目的属性正确
- 检查共享页面是否可访问