Getting Started

This section helps you take your first steps with OneNoteToWiki — from authorizing your Microsoft account to creating your first sync rule.

🔗 Connecting Your Microsoft Account

Before you can sync any content, you need to connect a Microsoft account that has access to the desired OneNote notebooks.

⚠️ Only Confluence administrators can connect Microsoft accounts and configure sync rules.

How to connect your account:

  1. Navigate to Apps → OneNoteToWiki

  2. Open the configuration page (admin section)

  3. Click “Connect Microsoft Account”

  4. You’ll be redirected to a Microsoft login and authorization screen

  5. Sign in and grant access to OneNote and related services

  6. You’ll be redirected back to the configuration interface once complete

After this step, the app can read your notebooks and allow you to define sync rules.

📄 Creating Your First Sync Rule

With your Microsoft account connected, you can now define what content should be synced to Confluence.

Steps:

  1. On the OneNoteToWiki configuration page, click “Create new rule”

  2. Select a notebook

  3. Define the target Confluence space and a parent page (recommended)

  4. Click “Save” to activate the rule

Each rule defines a mapping between OneNote content and Confluence pages.

🧭 Recommended Best Practices

  • Always set a parent page to easily locate or remove synced content

  • Start small: test with a small notebook or a single section

  • Use a test space before rolling out in production

🚧 Known Limitations (Current Version)

  • Only admins can create and manage rules

  • Users cannot yet log in individually or create personal syncs

  • The sync process may take hours or days for large notebooks due to API rate limits (Microsoft Graph & Atlassian Forge)

  • Currently supports Confluence Cloud only