Loading...

Back to Details

notion-integration

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Notion 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

确认页面存在且内容匹配
验证数据库条目的属性正确
检查共享页面是否可访问