Mintlify

Mintlify reads your repo, converts content from Markdown, HTML, or plain files into MDX, and generates ready-to-deploy Mintlify docs. It maps headings, code blocks, frontmatter, and assets into the right MDX components, creates table-of-contents entries, and writes routes and metadata so the site builds predictably. It also validates links and flags missing images or broken references before you publish.

You can run it to batch-convert existing docs, or wire it into CI to watch branches and create pull requests that add or update pages. It commits converted files, updates navigation, and can tag changes. It exposes options to customize which components wrap code samples, how props are mapped, and how examples are embedded so the output matches your style guide.

Imagine a repo where docs live in mixed formats and engineers are filing PRs just to fix docs. Mintlify reads those files, converts and syncs them into MDX, opens PRs with the changes, and updates the site config. That avoids context-switching between editors and hosting consoles and saves hours on manual conversions during a release.