notion-docs-enhancer（Notion 文档 enhancer）

Notion 文档增强 Skill

概述

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

核心能力

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

使用方法

基本用法

帮我完善这个 Notion 文档：https://www.notion.so/xxx
内容：[你的 Markdown 内容]

快速创建

在我的 Notion 创建一个关于 [主题] 的文档，包含以下章节：
1. 概述
2. 功能说明
3. 使用指南

操作流程

步骤 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 语法：

常见问题处理

问题: 内容输入到了标题中 解决: 使用 Meta+z 撤销，确保先移动光标到内容区域

问题: 菜单弹出阻挡输入 解决: 按 Escape 关闭菜单，或按 ArrowDown 移动到内容区

问题: 页面需要登录 解决: 确保浏览器中已登录 Notion 账号

模板内容

技术文档模板

## 一、概述

[产品/功能简介]

## 二、核心功能

| 功能 | 说明 |
|------|------|
| 功能1 | 描述 |
| 功能2 | 描述 |

## 三、使用指南

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

## 四、最佳实践

- 建议一
- 建议二

## 五、参考资源

- [资源链接](url)

会议纪要模板

## 会议信息

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

## 议程

1. 议题一
2. 议题二

## 讨论要点

### 议题一
- 要点

### 议题二
- 要点

## 行动项

| 任务 | 负责人 | 截止日期 |
|------|--------|----------|
| 任务1 | @人员 | 日期 |

## 下次会议

- 时间：
- 主题：

注意事项

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

详细参考

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