Notion 文档增强 Skill
概述
此 Skill 通过 Playwright 浏览器自动化帮助用户快速创建和完善 Notion 文档，无需 Notion API 授权。
核心能力
-
创建/修改页面标题 - 自动导航到页面并修改标题
-
粘贴 Markdown 内容 - 自动转换为 Notion 原生格式（标题、列表、表格、链接）
-
清理冗余内容 - 删除多余的文本块
-
截图验证 - 自动截图确认最终效果
使用方法
基本用法
帮我完善这个 Notion 文档：https://www.notion.so/xxx 内容：[你的 Markdown 内容]
快速创建
在我的 Notion 创建一个关于 [主题] 的文档，包含以下章节：
- 概述
- 功能说明
- 使用指南
操作流程
步骤 1: 导航到页面
// 使用 Playwright MCP 工具 await mcp__plugin_playwright_playwright__browser_navigate({ url: "https://www.notion.so/page-id" });
步骤 2: 等待页面加载
await mcp__plugin_playwright_playwright__browser_wait_for({ time: 3 // 等待 3 秒确保页面完全加载 });
步骤 3: 修改标题
// 获取页面快照找到标题元素 await mcp__plugin_playwright_playwright__browser_snapshot();
// 点击标题按钮 await mcp__plugin_playwright_playwright__browser_click({ element: "页面标题", ref: "title-ref" });
// 输入新标题 await mcp__plugin_playwright_playwright__browser_type({ element: "标题输入框", ref: "input-ref", text: "新标题" });
// 确认 await mcp__plugin_playwright_playwright__browser_press_key({ key: "Enter" });
步骤 4: 粘贴内容（关键技巧）
// 使用 browser_run_code 执行复杂操作
await mcp__plugin_playwright_playwright__browser_run_code({
code: async (page) => { const content = \## 一、概述
你的 Markdown 内容...
二、功能说明
| 列1 | 列2 |
|---|---|
| 值1 | 值2 |
| `; |
// 写入剪贴板
await page.evaluate((text) => {
navigator.clipboard.writeText(text);
}, content);
// 等待
await page.waitForTimeout(500);
// 粘贴（Notion 会自动转换 Markdown）
await page.keyboard.press('Meta+v');
return 'Content pasted';
}` });
步骤 5: 清理和验证
// 删除多余内容 await mcp__plugin_playwright_playwright__browser_click({ element: "多余文本", ref: "ref" }); await mcp__plugin_playwright_playwright__browser_press_key({ key: "Backspace" });
// 截图验证 await mcp__plugin_playwright_playwright__browser_take_screenshot({ filename: "notion-result.png", fullPage: true });
// 关闭浏览器 await mcp__plugin_playwright_playwright__browser_close();
重要技巧
Markdown 自动转换
Notion 在粘贴时会自动转换以下 Markdown 语法：
Markdown Notion 效果
标题
二级标题
- 列表项
无序列表
- 列表项
有序列表
` 表格
超链接
粗体
粗体文本
代码
行内代码
常见问题处理
问题: 内容输入到了标题中 解决: 使用 Meta+z 撤销，确保先移动光标到内容区域
问题: 菜单弹出阻挡输入 解决: 按 Escape 关闭菜单，或按 ArrowDown 移动到内容区
问题: 页面需要登录 解决: 确保浏览器中已登录 Notion 账号
模板内容
技术文档模板
一、概述
[产品/功能简介]
二、核心功能
| 功能 | 说明 |
|---|---|
| 功能1 | 描述 |
| 功能2 | 描述 |
三、使用指南
- 步骤一
- 步骤二
- 步骤三
四、最佳实践
- 建议一
- 建议二
五、参考资源
会议纪要模板
会议信息
- 日期：YYYY-MM-DD
- 参会人：
- 主持人：
议程
- 议题一
- 议题二
讨论要点
议题一
- 要点
议题二
- 要点
行动项
| 任务 | 负责人 | 截止日期 |
|---|---|---|
| 任务1 | @人员 | 日期 |
下次会议
- 时间：
- 主题：
注意事项
-
浏览器状态: 确保 Playwright 浏览器已安装（npx playwright install chromium ）
-
登录状态: 首次使用需要在浏览器中登录 Notion
-
页面权限: 确保你有编辑目标页面的权限
-
网络连接: 需要稳定的网络连接
详细参考
-
完整 API 参考见 REFERENCE.md
-
更多使用示例见 EXAMPLES.md