mintlify

You can convert MDX files into a structured documentation site by configuring docs.json for navigation and writing MDX pages with required frontmatter. This process transforms content into a browsable website following Mintlify best practices.

Configuring navigation for a Mintlify documentation site is done by defining site-wide settings, theme, and navigation structure within the docs.json file. This ensures the generated documentation site remains consistent and structured.

Generating API reference pages from an OpenAPI specification is supported through auto-generated pages driven by your OpenAPI definition. You can also create manual endpoint pages for API documentation when needed.

Yes, Mintlify requires MDX pages to include page frontmatter, specifically title and description fields. Following these content authoring standards ensures your documentation meets the required file conventions and best practices.

Yes, you can and should use root-relative internal links when authoring MDX documentation content. Leveraging root-relative links is a Mintlify best practice that ensures correct file conventions across your documentation site.