notion-docs-enhancer

此 Skill 通过 Playwright 浏览器自动化帮助用户快速创建和完善 Notion 文档，无需 Notion API 授权。

1. 创建/修改页面标题 - 自动导航到页面并修改标题
2. 粘贴 Markdown 内容 - 自动转换为 Notion 原生格式（标题、列表、表格、链接）
3. 清理冗余内容 - 删除多余的文本块
4. 截图验证 - 自动截图确认最终效果

基本用法

```

帮我完善这个 Notion 文档：https://www.notion.so/xxx

内容：[你的 Markdown 内容]

```

快速创建

```

在我的 Notion 创建一个关于 [主题] 的文档，包含以下章节：

1. 概述
2. 功能说明
3. 使用指南

```

步骤 1: 导航到页面

```javascript

// 使用 Playwright MCP 工具

await mcp__plugin_playwright_playwright__browser_navigate({

url: "https://www.notion.so/page-id"

});

```

步骤 2: 等待页面加载

```javascript

await mcp__plugin_playwright_playwright__browser_wait_for({

time: 3 // 等待 3 秒确保页面完全加载

});

```

步骤 3: 修改标题

```javascript

// 获取页面快照找到标题元素

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: 粘贴内容（关键技巧）

```javascript

// 使用 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: 清理和验证

```javascript

// 删除多余内容

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 效果 |

|----------|------------|

| ## 标题 | 二级标题 |

| - 列表项 | 无序列表 |

| 1. 列表项 | 有序列表 |

| | 表格 | | 表格 |

| [链接](url) | 超链接 |

| 粗体 | 粗体文本 |

| ` 代码 ` | 行内代码 |

常见问题处理

问题: 内容输入到了标题中

解决: 使用 Meta+z 撤销，确保先移动光标到内容区域

问题: 菜单弹出阻挡输入

解决: 按 Escape 关闭菜单，或按 ArrowDown 移动到内容区

问题: 页面需要登录

解决: 确保浏览器中已登录 Notion 账号

技术文档模板

```markdown

[产品/功能简介]

| 功能 | 说明 |

|------|------|

| 功能1 | 描述 |

| 功能2 | 描述 |

1. 步骤一
2. 步骤二
3. 步骤三

• 建议一
• 建议二

• [资源链接](url)

```

会议纪要模板

```markdown

• 日期：YYYY-MM-DD
• 参会人：
• 主持人：

1. 议题一
2. 议题二

议题一

• 要点

议题二

• 要点

| 任务 | 负责人 | 截止日期 |

|------|--------|----------|

| 任务1 | @人员 | 日期 |

• 时间：
• 主题：

```

1. 浏览器状态: 确保 Playwright 浏览器已安装（npx playwright install chromium）
2. 登录状态: 首次使用需要在浏览器中登录 Notion
3. 页面权限: 确保你有编辑目标页面的权限
4. 网络连接: 需要稳定的网络连接

• 完整 API 参考见 [REFERENCE.md](REFERENCE.md)
• 更多使用示例见 [EXAMPLES.md](EXAMPLES.md)