帮助文档

全面的指南和教程，帮助您充分利用 MarkFlow

快速入门

三步开始使用 MarkFlow

1

下载并安装 MarkFlow

从官网下载适合您操作系统的版本并完成安装

2

配置 Notion API Key

在设置页面输入您的 Notion API Key 和目标页面 URL

3

选择文件夹开始同步

选择包含 Markdown 文件的文件夹，预览后开始同步

功能指南

手动同步

手动选择文件夹，预览同步内容，实时进度显示。图形化界面让同步操作直观易懂。

  • 文件夹选择
  • 预览功能
  • 实时进度

自动同步

智能文件监控，稳定可靠的同步机制。文件变更时自动同步到 Notion。

  • 文件监控
  • 自动触发
  • 状态显示

配置管理

安全的账户连接，连接测试，页面配置。一次设置，永久使用。

  • API Key 配置
  • 连接测试
  • 安全存储

历史记录

完整同步记录，统计分析，搜索筛选。让每次操作都有迹可循。

  • 同步记录
  • 统计分析
  • 搜索筛选

配置指南

如何获取 Notion API Key

  1. 访问 Notion 开发者页面 Notion 开发者页面
  2. 点击 "New integration" 创建新的集成应用
  3. 填写集成名称（如 "MarkFlow"）并选择工作空间
  4. 复制生成的 "Internal Integration Token"
  5. 在 MarkFlow 设置中粘贴此 Token

页面权限设置

  1. 在 Notion 中打开目标页面
  2. 点击页面右上角的 "Share" 按钮
  3. 在 "Invite" 部分搜索您创建的集成名称
  4. 选择集成并点击 "Invite"
  5. 确保集成具有 "Edit" 权限

故障排除

同步失败，显示 "API Key 无效"

请检查以下几点：

  • 确认 API Key 复制完整，没有多余的空格
  • 检查 API Key 是否已过期
  • 确认集成应用状态正常
无法访问 Notion 页面

可能的解决方案：

  • 确认页面 URL 正确
  • 检查集成是否已被邀请到该页面
  • 确认集成具有编辑权限
自动同步不工作

可能的解决方案：

  • 检查文件夹路径是否正确
  • 确认自动同步功能已启用
  • 重启应用程序