Aller au contenu principal

Migrate from Mintlify

Most of a Mintlify site moves to Docsio cleanly because both write standard MDX. The pieces that need a hand are the navigation config (docs.json → Docsio's auto-generated structure) and a few Mintlify-specific components.

The fastest path

If your Mintlify docs are public, paste the URL into Docsio's URL onboarding. It scrapes every page, extracts your brand, and writes a Docsio version directly. You'll spend ten minutes auditing the output, not days hand-converting MDX.

For private repos or stricter migrations, export the markdown from Mintlify (or just git clone your docs repo), drop the files into Docsio's file-upload onboarding, and let the AI agent plan the structure.

What carries over without edits

  • Standard markdown — headings, paragraphs, lists, code blocks, tables.
  • MDX syntax inside .mdx files.
  • Frontmatter keys like title and description.
  • <Tip>, <Note>, <Warning>, <Info> admonition components — these match Docusaurus admonitions one-to-one.
  • Tabbed code blocks (Mintlify's <CodeGroup> becomes Docsio's standard `tabbed` syntax automatically when you use the agent).

What needs translation

  • docs.json navigation — Docsio doesn't use a navigation config file. The sidebar is generated from your folder structure plus _category_.json files. The agent rebuilds this from your docs.json automatically when you ask.
  • <Frame> and <img> with data-path — these are Mintlify-specific. Replace with plain ![alt](url) markdown or the <Card> component for image-prefixed cards.
  • <AccordionGroup> / <Accordion> — replace with Docsio's collapsed-section syntax (HTML <details> works) or rewrite as inline content. Most accordions hide content the reader needs anyway.
  • <Steps> — Docsio has a simple ordered-list pattern that renders the same way. The agent converts these on import.

A note on writing style

Mintlify docs tend toward terse, recipe-style writing. Docsio works the same way out of the box — the AI agent's house style is short paragraphs, opinionated defaults, and code over prose. If you've been holding back longer prose because Mintlify's components didn't fit, you have more flexibility here.

Rough timeline

For a 50-page Mintlify site with normal complexity:

  • URL onboarding: about 8–12 minutes for the AI to scrape and write everything.
  • Hand-audit: 1–2 hours to fix any extraction misses and adjust tone.
  • Brand pass: 30 minutes to swap in your final logo + tweak colors.

Total: half a day, not a quarter. The longest part is reviewing what the AI wrote, not waiting for it.