AI agents: fetch the documentation index 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 Blode.md. 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. Blode.md is the git path without
the editor or the marketplace: the same MDX files, a smaller docs.json, and
one command to publish.
Blode.md'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
blodemd 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 blodemd - A Blode.md account: run
blodemd loginonce (it opens GitHub OAuth)
Steps
Your pages carry over as they are. Move the 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 Blode.md