hatch-surf/node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/mdx-components.md

title	description	related
mdx-components.js	API reference for the mdx-components.js file.	title links Learn more about MDX Components app/guides/mdx

The mdx-components.js|tsx file is required to use @next/mdx with App Router and will not work without it. Additionally, you can use it to customize styles.

Use the file mdx-components.tsx (or .js) in the root of your project to define MDX Components. For example, at the same level as pages or app, or inside src if applicable.

import type { MDXComponents } from 'mdx/types'

const components: MDXComponents = {}

export function useMDXComponents(): MDXComponents {
  return components
}

const components = {}

export function useMDXComponents() {
  return components
}

Exports

useMDXComponents function

The file must export a single function named useMDXComponents. This function does not accept any arguments.

import type { MDXComponents } from 'mdx/types'

const components: MDXComponents = {}

export function useMDXComponents(): MDXComponents {
  return components
}

const components = {}

export function useMDXComponents() {
  return components
}

Version History

Version	Changes
v13.1.2	MDX Components added