This guide helps you move your existing documentation to Mintlify. Choose automated migration for supported platforms or manual migration for complete control over the process.

Choose your migration path

Automated migration

If you are migrating from Docusaurus, ReadMe, or GitBook, use our tools to automate your migration.

Manual migration

If you are migrating from any other platform, follow our guide to migrate your content.
Migrate your documentation using the @mintlify/scraping package. The package scrapes your content and converts it to use Mintlify components.

Supported Platforms

Docusaurus

ReadMe

GitBook (beta)

If your documentation is hosted on another platform, see the manual migration steps.

Installing the scraper

Install the @mintlify/scraping package to get started.
npm install @mintlify/scraping@latest -g

Scraping pages and sections

The migration tool automatically detects your documentation platform and converts your content. Prepared files are stored locally in ./docs by default.For large documentation sites, migrate smaller sections at a time rather than the entire site at once.Migrate entire sections:
mintlify-scrape section https://your-docs-site.com/docs
Migrate single pages:
mintlify-scrape page https://your-docs-site.com/docs/getting-started
Migrate OpenAPI specifications:
mintlify-scrape openapi-file [openApiFilename]

Add prepared content to your Mintlify project

After scraping your existing documentation platform, you are ready to build your docs on Mintlify.Confirm that all of your pages have been migrated then add these files to the documentation repository that you created during the onboarding process. This is usually a GitHub repository.

Post-migration checklist

After completing your migration (automated or manual), we recommend checking:
  • All pages render
  • Navigation works as intended
  • Internal links resolve properly
  • Images and assets load correctly
  • Code blocks display with proper syntax highlighting
  • Search functionality works
  • Deployment is configured
  • Custom domain is set up