Skip to content
Theme UI

Themed component

Use the Themed components dict to render UI with styles from theme.styles outside of MDX or inside of more complex components meant for embedding in MDX.

For example, if you'd like to reuse heading styles in a React component, you can use the Themed.h1 component to render an <h1> element with styles from theme.styles.h1.

import type { ComponentPropsWithoutRef } from 'react'
import { Themed } from '@theme-ui/mdx'
export const components = {
h2: (props: ComponentPropsWithoutRef<'h2'>) => (
<h2 {...props}>
{ ? (
<Themed.a href={`#${}`}>{props.children}</a>
) : (
export const theme = {
styles: {
a: {
textDecoration: 'none',
':hover': {
textDecoration: 'underline',

For a full list of keys available, see the Theme Specification docs.

Global styles

To add base typographic styles to the <html> element, add styles to theme.styles.root. See the theming docs for more information, including how to disable this.

Edit the page on GitHub
Styling MDX
Custom Components