Move your docs to Typemark.
Tell us where your docs live today. We’ll show you what moves across on its own, what needs a quick look, and the easiest way to bring it all over.
From Mintlify
Your pages and Mintlify components work as they are. Typemark reads your docs.json, adds a typemark.json next to it and leaves your pages alone.
Recommended
Import from GitHub
Choose your repository. Typemark finds your docs.json or mint.json, even a couple of folders down, adds a typemark.json and builds your site.
Terminal
The Typemark CLI
cd my-docstypemark migrate # converts, then offers to create and pushtypemark migrate --create --push # or all of it, no questionsAgent
Your coding agent
typemark migrate --agent claudeYour agent runs on your computer, under your own account, and follows our migration guide.
| In Mintlify | On Typemark | How |
|---|---|---|
| docs.json navigation | Tabs, groups and pages | Automatic |
| <Note>, <Columns>, <Steps>… | Same tags, saved as written | Automatic |
| Redirects | Exact paths carried over, wildcards skipped | Partly |
| Languages | Every language, with the default navigation | Partly |
| Versions | The default one only | Partly |
| Snippets | Paste the content into each page | Manual |
From GitBook
First, sync your space to GitHub. Typemark reads your SUMMARY.md for the navigation and turns GitBook blocks into components. The rest of your Markdown stays as it is.
Recommended
Import from GitHub
Turn on Git Sync in GitBook with an empty GitHub repository, then import it here. All the changes land in a single commit you can look over.
Terminal
The Typemark CLI
cd my-gitbook-repotypemark migrate # converts, then offers to create and pushtypemark migrate --create --push # or all of it, no questionsAgent
Your coding agent
typemark migrate --from gitbook --agent claudeYour agent runs on your computer, under your own account, and follows our migration guide.
| In GitBook | On Typemark | How |
|---|---|---|
| SUMMARY.md | Groups and pages | Automatic |
| {% hint style="info" %} | <Info> | Automatic |
| {% tabs %} / {% stepper %} | <Tabs> / <Steps> | Automatic |
| .gitbook/assets/ | Moved to images/, every link updated | Automatic |
| {% include %} | Inlined into each page | Partly |
| Organization-level OpenAPI | Add the spec file to the repository | Manual |
From ReadMe
Connect ReadMe’s sync to a new, empty GitHub repository, then import it. Your categories and page order become your navigation.
Recommended
Import from GitHub
Import the repository ReadMe synced to. Your categories become groups, pages stay in the same order and callouts keep working.
Terminal
The Typemark CLI
cd my-readme-repotypemark migrate # converts, then offers to create and pushtypemark migrate --create --push # or all of it, no questionsAgent
Your coding agent
typemark migrate --from readme --agent claudeYour agent runs on your computer, under your own account, and follows our migration guide.
| In ReadMe | On Typemark | How |
|---|---|---|
| docs/ folders, _order.yaml | Groups and page order | Automatic |
| excerpt, hidden | Page description, hidden from the sidebar | Automatic |
| <Callout theme="info"> | Works as written | Automatic |
| reference/ OpenAPI files | Generated API pages | Automatic |
| Recipes, custom pages | Regular pages | Partly |
| Images on files.readme.io | Still load from ReadMe; download them before you cancel | Manual |
From anywhere else
Your coding agent does the moving. It reads your old docs, writes Typemark pages using our migration guide and checks its own work until the site builds.
In the app
Import from GitHub
When the converted site is in a GitHub repository, import it like any other. Or publish it straight from your terminal.
Terminal
The Typemark CLI
cd my-converted-docstypemark checktypemark create my-docs # and links this foldertypemark push --prune --waitRecommended
Your coding agent
typemark migrate --agent claude --source ../old-docsYour agent runs on your computer, under your own account, and follows our migration guide.
| In your current docs | On Typemark | How |
|---|---|---|
| Markdown and MDX pages | Pages | With your agent |
| Sidebar config | typemark.json navigation | With your agent |
| Admonitions, tabs | Typemark components | With your agent |
| A live site only | Saved page by page first | With your agent |
Why moving is safe
Old links keep working
The redirects you already have in Mintlify or GitBook come with you. If any other paths change, add a redirect before you move your domain.
Nothing disappears quietly
After the import, a summary shows every page it found, anything that’s missing, and each setting or component it couldn’t bring across.
Try it without risk
Your old site stays up while you look around. Every change the import makes is a Git commit you can review or undo, and your new site stays offline until you click Go live.
Bring your docs over.
Start for free and import your repository. Nothing goes public until you’re ready.
14-day Pro trial, no card. Your content stays in Git.