docs: add documentation for Obsidian to NotionNext plugin setup and usage

2026-07-31 10:00:05 +08:00 · 2025-10-31 10:47:34 +00:00
parent db66ef137c
commit e944721415
14 changed files with 554 additions and 0 deletions
--- a/docs/zh/01-getting-started.md
+++ b/docs/zh/01-getting-started.md
@@ -0,0 +1,45 @@
+---
+title: 开始使用
+description: Obsidian to NotionNext 插件设置指南
+---
+
+# 开始使用
+
+## 获取 Notion API 令牌
+
+在使用本插件前，你需要从 Notion 获取一个 API 令牌（Token），以授权插件访问你的 Notion 账户。
+
+1. 前往 [Notion API](https://www.notion.so/profile/integrations) 页面来创建一个新的集成（integration）。你需要先登录你的 Notion 账户。
+2. 点击 `+ New integration`。
+![new-integration](https://r2imga.jxpeng.dev/2025/10/3d12358494c000ab7035820e1e836934.png)
+3. 填写一些基本信息：
+![integration-info](https://r2imga.jxpeng.dev/2025/10/645b8182105e5e64e61bd263394534d6.png)
+4. 成功创建集成。
+![success](https://r2imga.jxpeng.dev/2025/10/57ea92c48efc15b95a69f3663424f5ae.png)
+5. 进入“配置集成设置”页面，**准备好复制 API 令牌**，你很快就会在插件设置中用到它。
+![configure-integration](https://r2imga.jxpeng.dev/2025/10/4a50e55c35e47f905fb7fe63af5c8402.png)
+
+::: warning
+**⚠️ 注意：** 请妥善保管你的 API 令牌，不要与他人分享，因为它授予了访问你 Notion 数据的权限。
+:::
+
+## 创建 Notion 数据库并连接集成
+
+接下来，你需要创建一个 Notion 数据库，用于存放从 Obsidian 同步过来的笔记。
+
+1. 在你的 Notion 工作区中，点击 `Create a new page` 来创建一个新页面。
+![create-new-page](https://r2imga.jxpeng.dev/2025/10/1f092ef1d8c5a25aeb75694d654810a1.png)
+
+2. 创建一个新页面后，选择 `Database - Full page` 选项。
+![new-database](https://r2imga.jxpeng.dev/2025/10/73b700fc65a53f2ff518b58832bf9757.png)
+
+3. 点击数据库页面右上角的 `...` 菜单，进入 `Connections`，然后连接你刚刚创建的集成。
+![connect-integration](https://r2imga.jxpeng.dev/2025/10/e8d9be4718f6f5c76fdc3bee7d694d23.png)
+
+4. 点击 `Share` -> `Publish`，将数据库发布到网络。
+![publish](https://r2imga.jxpeng.dev/2025/10/4b1d3f597d67508ee67d20a62151200f.png)
+
+5. 点击并复制 **数据库 ID**。
+![database-id](https://r2imga.jxpeng.dev/2025/10/d8f22c1daf5063305256e5e50210adf9.png)
+
+接下来，你可以根据[安装指南](./02-installation.md)在 Obsidian 中安装和配置插件了。