docs(markdown): clarify minimal parser scope and recommend HTML route

Add callouts to the Markdown import and format-interoperability pages
explaining that BlockNote's built-in Markdown parser targets a minimal
CommonMark + GFM subset, and that users with broader Markdown needs
should parse to HTML themselves and use tryParseHTMLToBlocks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: nperez0111

docs/content/docs/features/import/markdown.mdx

@@ -15,6 +15,12 @@ imageTitle: Markdown Import
 
 BlockNote can import Markdown content into Block objects. Note that this is considered "lossy", as not all Markdown structures can be entirely represented as BlockNote blocks.
 
+<Callout type={"warning"}>
+    **BlockNote ships a minimal Markdown parser.** It covers the common subset used by most users (CommonMark + GFM basics: headings, paragraphs, lists, task lists, tables, code, blockquotes, links, images, emphasis, strikethrough, hard breaks).
+
+    There are many Markdown specifications (CommonMark, GFM, MDX, Pandoc, and various dialect-specific extensions) and supporting all of them inside a rich text editor is not a goal of BlockNote. **If you need to handle Markdown beyond this minimal subset, parse it to HTML yourself with a parser of your choice (e.g. [`marked`](https://github.com/markedjs/marked), [`markdown-it`](https://github.com/markdown-it/markdown-it), or [`remark`](https://github.com/remarkjs/remark)) and pass the resulting HTML to [`tryParseHTMLToBlocks`](/docs/features/import) instead.** BlockNote's HTML interoperability is much broader, since HTML is the format the editor uses internally for arbitrary pastes.
+</Callout>
+
 ## Markdown to Blocks
 
 Use `tryParseMarkdownToBlocks` to try parsing a Markdown string into `Block` objects:

docs/content/docs/foundations/supported-formats.mdx

@@ -165,6 +165,20 @@ export default function App() {
 
 BlockNote also supports converting to and from Markdown. However, converting to and from Markdown is a **lossy** conversion.
 
+<Callout type="warning">
+  BlockNote ships a **minimal** Markdown parser/serializer that targets the
+  common CommonMark + GFM subset (headings, paragraphs, lists, task lists,
+  tables, code, blockquotes, links, images, emphasis, strikethrough, hard
+  breaks). Supporting every Markdown dialect (CommonMark, GFM, MDX, Pandoc,
+  and various extensions) is not a goal for the editor. If your use case
+  requires Markdown features beyond this subset, **parse the Markdown to
+  HTML yourself** (with a library like [`marked`](https://github.com/markedjs/marked),
+  [`markdown-it`](https://github.com/markdown-it/markdown-it), or
+  [`remark`](https://github.com/remarkjs/remark)) and feed the resulting
+  HTML to `editor.tryParseHTMLToBlocks` — HTML is the format BlockNote uses
+  for arbitrary pastes and has much broader interoperability.
+</Callout>
+
 ### Saving as Markdown
 
 To convert the document to a Markdown string, you can use `editor.blocksToMarkdownLossy()`: