Skip to Content
🚧 This is WIP documentation for Nextra 4.0. Dima Machina is looking for a new job or consulting .

mdx-components.js File

The mdx-components file is required, you use it to customize styles via useMDXComponents function.

Exports

useMDXComponents function

The file must export a single function named useMDXComponents.

mdx-components.js
import { useMDXComponents as getThemeComponents } from 'nextra-theme-docs' // nextra-theme-blog or your custom theme // Get the default MDX components const themeComponents = getThemeComponents() // Merge components export function useMDXComponents(components) { return { ...themeComponents, ...components } }

Params

components

When defining MDX Components, the export function accepts a single parameter components: MDXComponents.

  • The key is the name of the HTML element to override.
  • The value is the component to render instead.
💡
Tip

You can keep mdx-components file in root of your project, or in src directory.

The .js, .jsx, or .tsx file extensions can be used for mdx-components file.

Last updated on