fix: allow configuring the email body's styles

[nperez0111]

Summary

This allows customize the React email exporter's body element (which we add some default styles to)

Rationale

This allows customizing things like the email's fontSize

Changes

expose an additional option to the conversion function

Impact

Testing

Added a snap with using something other than the defaults

Screenshots/Video

Checklist

• Code follows the project's coding standards.
• Unit tests covering the new feature have been added.
• All existing tests pass.
• The documentation has been updated to reflect the new feature

Additional Notes

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
blocknote	Ready	Preview	Nov 18, 2025 4:21pm
blocknote-website	Ready	Preview	Nov 18, 2025 4:21pm

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/ariakit@2182

@blocknote/code-block

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/code-block@2182

@blocknote/core

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/core@2182

@blocknote/mantine

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/mantine@2182

@blocknote/react

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/react@2182

@blocknote/server-util

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/server-util@2182

@blocknote/shadcn

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/shadcn@2182

@blocknote/xl-ai

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-ai@2182

@blocknote/xl-docx-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-docx-exporter@2182

@blocknote/xl-email-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-email-exporter@2182

@blocknote/xl-multi-column

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-multi-column@2182

@blocknote/xl-odt-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-odt-exporter@2182

@blocknote/xl-pdf-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-pdf-exporter@2182

commit: 02d6c5b

[noudadrichem]

Would be nice to align the defaults in the mdx with the default here. For me these values in the export were a mystery before I found them here.

[nperez0111]

@noudadrichem sorry I don't completely understand by "the defaults in the mdx"

Do you mean the defaults for the individual blocks in the export like here:

BlockNote/packages/xl-email-exporter/src/react-email/defaultSchema/blocks.tsx

Lines 40 to 116 in 0ef29d2

	const defaultTextStyle: TextProps["style"] = {
	fontSize: 16,
	lineHeight: 1.5,
	margin: 3,
	minHeight: 24,
	};
	// Default styles for Text components
	export const defaultReactEmailTextStyles = {
	paragraph: {
	style: defaultTextStyle,
	},
	bulletListItem: {
	style: defaultTextStyle,
	},
	toggleListItem: {
	style: defaultTextStyle,
	},
	numberedListItem: {
	style: defaultTextStyle,
	},
	checkListItem: {
	style: defaultTextStyle,
	},
	quote: {
	style: defaultTextStyle,
	},
	tableError: {
	style: defaultTextStyle,
	},
	tableCell: {
	style: defaultTextStyle,
	},
	caption: {
	style: defaultTextStyle,
	},
	heading1: {
	style: {
	fontSize: 48,
	margin: 3,
	},
	},
	heading2: {
	style: {
	fontSize: 36,
	margin: 3,
	},
	},
	heading3: {
	style: {
	fontSize: 24,
	margin: 3,
	},
	},
	heading4: {
	style: {
	fontSize: 20,
	margin: 3,
	},
	},
	heading5: {
	style: {
	fontSize: 18,
	margin: 3,
	},
	},
	heading6: {
	style: {
	fontSize: 16,
	margin: 3,
	},
	},
	codeBlock: {
	style: defaultTextStyle,
	},
	} satisfies ReactEmailTextStyles;

Or, do you mean something else entirely. There isn't any mdx here

[nperez0111]

In the docs maybe? Like a callout that if not specified it'd be these values?

[nperez0111]

Updated the docs

[noudadrichem]

I meant the docs indeed: docs/content/docs/features/export/email.mdx