docs: Default block configuration example

[matthewlipski]

Summary

This PR adds an example for configuring default blocks. Specifically, it configures the default heading block to allow only levels 1-3 and removes their toggleable variants.

It also updates the docs to provide more info on default block configuration.

Rationale

These features are mostly undocumented atm, so this is a needed addition.

Changes

• Added heading configuration example.
• Updated default block types docs.

Impact

N/A

Testing

N/A

Screenshots/Video

N/A

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	Oct 16, 2025 11:03am
blocknote-website	Ready	Preview	Oct 16, 2025 11:03am

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

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

@blocknote/code-block

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

@blocknote/core

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

@blocknote/mantine

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

@blocknote/react

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

@blocknote/server-util

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

@blocknote/shadcn

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

@blocknote/xl-ai

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

@blocknote/xl-docx-exporter

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

@blocknote/xl-email-exporter

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

@blocknote/xl-multi-column

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

@blocknote/xl-odt-exporter

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

@blocknote/xl-pdf-exporter

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

commit: 2deb465

[nperez0111]

Thanks for doing this!

[YousefED]

@matthewlipski @nperez0111 🙄

[nperez0111]

@matthewlipski @nperez0111 🙄

That's weird, it works for me...

Now that I'm looking at the menu stuff, I see how easily this sort of thing can get out of sync though, so maybe I'll fix this

[matthewlipski]

The issue is that heading levels >3 are in the block type select, which should be disabled. Working on a fix rn, should take like 15 mins.

[matthewlipski]

#2112