For AI agents: the documentation index is at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
Migrate from Mintlify
Move a Mintlify docs repo to Edda. Copy the MDX, rewrite docs.json to the smaller schema, validate, preview, push, and keep your domain.
Mintlify's git workflow is MDX in the repo, a docs.json beside it, a web
editor that commits back, and a marketplace. Edda is the git path without
the editor or the marketplace: the same MDX files, a smaller docs.json, and
one command to publish.
Edda's docs.json is deliberately smaller than Mintlify's. Top-level keys
such as name, navigation, navbar, and logo exist in both, but theme,
colors, fonts, icons, background, and styling are not supported, and
edda validate reports every key it does not recognise as an error. Expect to
edit the file, not just copy it.
Prerequisites
- Node.js 24.x
- The CLI:
npm i -g edda-docs - A Edda account: run
edda loginonce (it opens GitHub OAuth)
Steps
Your pages carry over as they are. Move the .mdx files, the images they
reference, and your logo and favicon assets into one docs directory, with
at its root. Keep the same relative layout so page paths and
image links do not change.
Published with Edda