Skip to main content

Migrating from Notion to Knowledge Base

This guide will help you migrate your existing Notion database content to the new Knowledge Base structure.

Understanding the New Structure​

The Knowledge Base is organized into several main categories:

  • Getting Started - Basic setup and quick start guides
  • Use Cases - Common implementation scenarios
  • Best Practices - Recommended approaches and optimization tips
  • Guides - Step-by-step tutorials and implementation guides
  • FAQ - Frequently asked questions
  • Troubleshooting - Common issues and solutions

Migration Process​

Step 1: Export from Notion​

  1. Open your Notion database
  2. Click the "..." menu in the top right
  3. Select "Export"
  4. Choose format (Markdown recommended)
  5. Download the exported files

Step 2: Categorize Your Content​

Review your Notion content and categorize it into the Knowledge Base structure:

Example categorization:

  • Setup instructions → /knowledge-base/getting-started.md or /knowledge-base/guides/
  • Common workflows → /knowledge-base/use-cases.md
  • Tips and recommendations → /knowledge-base/best-practices.md
  • Q&A content → /knowledge-base/faq.md
  • Problem solutions → /knowledge-base/troubleshooting.md

Step 3: Content Format Conversion​

Convert your Notion content to match the Knowledge Base format.

Step 4: Create Individual Pages​

For each piece of content, create a new markdown file in the appropriate directory.

Step 5: Update Navigation​

If you add new pages, update the sidebars.ts file to include them in the navigation.

Need Help?​

If you need assistance with the migration:

  • Review the existing Knowledge Base structure for examples
  • Check our best practices for content guidelines
  • Contact our support team for additional guidance