feat(core): improve Word and Google Docs paste handling (#3226)

Author: nperez0111

docs/content/docs/reference/editor/paste-handling.mdx

@@ -21,6 +21,20 @@ BlockNote, by default, attempts to paste content in the following order:
 
 You can change the default paste behavior by providing a custom paste handler, which will give you full control over how pasted content is inserted into the editor.
 
+## Word and Google Docs
+
+BlockNote automatically converts Microsoft Word list paragraphs into nested lists,
+removes Word paragraph-end placeholders, and preserves blank paragraphs copied from
+Google Docs. This applies to external HTML pasted from the clipboard.
+
+This is a best-effort conversion into BlockNote's block types, not exact source
+formatting preservation. Unsupported list labels, such as `iv.` or `1.2.`, stay as
+text instead of being removed.
+
+To replace this behavior, use a custom `pasteHandler` and handle the HTML before
+calling `editor.pasteHTML`. Calling `defaultPasteHandler` keeps the built-in
+normalization. Internal BlockNote clipboard content bypasses this normalization.
+
 ## `pasteHandler` option
 
 The `pasteHandler` option is a function that receives the following arguments: