feat: content re-organization

.vscode/settings.json

@@ -18,5 +18,8 @@
   "search.defaultViewMode": "tree",
   "[typescript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[mdx]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   }
 }

examples/01-basic/02-block-objects/src/App.tsx

@@ -48,7 +48,7 @@ export default function App() {
       <div>Document JSON:</div>
       <div className={"item bordered"}>
         <pre>
-          <code>{JSON.stringify(blocks, null, 2)}</code>
+          <code>{JSON.stringify(editor.document, null, 2)}</code>
         </pre>
       </div>
     </div>

fumadocs/app/global.css

@@ -1,6 +1,7 @@
 @import "tailwindcss";
 @import "fumadocs-ui/css/vitepress.css";
 @import "fumadocs-ui/css/preset.css";
+@import "fumadocs-twoslash/twoslash.css";
 
 @source ".";
 @source "../components";

fumadocs/components/DocPage.tsx

@@ -22,7 +22,10 @@ export function CardTable({
 }) {
   return (
     <Cards>
-      {getPageTreePeers(source.pageTree, `${baseUrl}/${path}`).map((peer) => (
+      {getPageTreePeers(
+        source.pageTree,
+        `${baseUrl}/${path.startsWith("/") ? path.slice(1) : path}`,
+      ).map((peer) => (
         <Card key={peer.url} title={peer.name} href={peer.url}>
           {peer.description}
         </Card>

fumadocs/content/docs/editor-api/meta.json

@@ -1,15 +1,12 @@
 {
-  "title": "Editor API",
+  "title": "API",
   "pages": [
-    "manipulating-blocks",
-    "manipulating-inline-content",
+    "react",
+    "document-structure",
     "cursor-selections",
     "converting-blocks",
     "events",
     "server-processing",
-    "export-to-pdf",
-    "export-to-docx",
-    "export-to-odt",
     "..."
   ]
 }

fumadocs/content/docs/advanced/paste-handling.mdx → fumadocs/content/docs/editor-api/paste-handling.mdx

@@ -4,18 +4,14 @@ description: This section explains how to handle paste events in BlockNote.
 imageTitle: Paste Handling
 ---
 
-
-
-# Paste Handling
-
 BlockNote, by default, attempts to paste content in the following order:
 
--   VS Code compatible content
--   Files
--   BlockNote HTML
--   Markdown
--   HTML
--   Plain text
+- VS Code compatible content
+- Files
+- BlockNote HTML
+- Markdown
+- HTML
+- Plain text
 
 > In certain cases, BlockNote will attempt to detect markdown in the clipboard and paste that into the editor as rich text.
 
@@ -27,24 +23,23 @@ The `pasteHandler` option is a function that receives the following arguments:
 
 ```ts
 type PasteHandler = (context: {
-    event: ClipboardEvent;
-    editor: BlockNoteEditor;
-    defaultPasteHandler: (context?: {
-        prioritizeMarkdownOverHTML?: boolean;
-        plainTextAsMarkdown?: boolean;
-    }) => boolean;
+  event: ClipboardEvent;
+  editor: BlockNoteEditor;
+  defaultPasteHandler: (context?: {
+    prioritizeMarkdownOverHTML?: boolean;
+    plainTextAsMarkdown?: boolean;
+  }) => boolean;
 }) => boolean;
 ```
 
--   `event`: The paste event.
--   `editor`: The current editor instance.
--   `defaultPasteHandler`: The default paste handler. If you only need to customize the paste behavior a little bit, you can fall back on the default paste handler.
+- `event`: The paste event.
+- `editor`: The current editor instance.
+- `defaultPasteHandler`: The default paste handler. If you only need to customize the paste behavior a little bit, you can fall back on the default paste handler.
 
 The `defaultPasteHandler` function can be called with the following options:
 
--   `prioritizeMarkdownOverHTML`: Whether to prioritize Markdown content in `text/plain` over `text/html` when pasting from the clipboard.
--   `plainTextAsMarkdown`: Whether to interpret plain text as markdown and paste that as rich text or to paste the text directly into the editor.
-
+- `prioritizeMarkdownOverHTML`: Whether to prioritize Markdown content in `text/plain` over `text/html` when pasting from the clipboard.
+- `plainTextAsMarkdown`: Whether to interpret plain text as markdown and paste that as rich text or to paste the text directly into the editor.
 
 ## Custom Paste Handler
 
@@ -57,8 +52,10 @@ const editor = new BlockNoteEditor({
   pasteHandler: ({ event, editor, defaultPasteHandler }) => {
     if (event.clipboardData?.types.includes("text/my-custom-format")) {
       // You can do any custom logic here, for example you could transform the clipboard data before pasting it
-      const markdown = customToMarkdown(event.clipboardData.getData("text/my-custom-format"));
-
+      const markdown = customToMarkdown(
+        event.clipboardData.getData("text/my-custom-format"),
+      );
+
       // The editor is able paste markdown (`pasteMarkdown`), HTML (`pasteHTML`), or plain text (`pasteText`)
       editor.pasteMarkdown(markdown);
       // We handled the paste event, so return true, returning false will cancel the paste event
@@ -71,4 +68,4 @@ const editor = new BlockNoteEditor({
 });
 ```
 
-See an example of this in the [Custom Paste Handler](/examples/basic/custom-paste-handler) example.
+See an example of this in the [Custom Paste Handler](/examples/basic/custom-paste-handler) example.