testomatio-editor-blocks 0.4.24 → 0.4.26

package/package/editor/blocks/snippet.js

@@ -110,11 +110,11 @@ export const snippetBlock = createReactBlockSpec({
         if (!hasSnippets) {
             return (_jsx("div", { className: "bn-teststep bn-snippet", "data-block-id": block.id, children: _jsx("p", { className: "bn-snippet__empty", children: "No snippets in this project." }) }));
         }
-        return (_jsxs("div", { className: "bn-teststep bn-snippet", "data-block-id": block.id, onFocus: handleFieldFocus, children: [_jsxs("div", { className: "bn-snippet__header", children: [_jsx("span", { className: "bn-snippet__label", children: "Snippet" }), _jsx(SnippetDropdown, { value: resolvedTitle, placeholder: "Select Snippet", suggestions: snippetSuggestions, selectedId: snippetId, onSelect: handleSnippetSelect })] }), isSnippetSelected && snippetData && (_jsx("div", { className: "bn-snippet__content", dangerouslySetInnerHTML: {
-                        __html: snippetData
-                            .replace(/&/g, "&")
-                            .replace(/</g, "&lt;")
-                            .replace(/>/g, "&gt;"),
-                    } }))] }));
+        return (_jsxs("div", { className: "bn-teststep bn-snippet", "data-block-id": block.id, onFocus: handleFieldFocus, children: [_jsxs("div", { className: "bn-snippet__header", children: [_jsx("span", { className: "bn-snippet__label", children: "Snippet" }), _jsx(SnippetDropdown, { value: resolvedTitle, placeholder: "Select Snippet", suggestions: snippetSuggestions, selectedId: snippetId, onSelect: handleSnippetSelect })] }), isSnippetSelected && (_jsx("div", { className: "bn-snippet__content", children: snippetData ? (_jsx("span", { dangerouslySetInnerHTML: {
+                            __html: snippetData
+                                .replace(/&/g, "&amp;")
+                                .replace(/</g, "&lt;")
+                                .replace(/>/g, "&gt;"),
+                        } })) : (_jsx("span", { className: "bn-snippet__empty", children: "No content here. Please update the snippet." })) }))] }));
     },
 });

package/package/editor/blocks/step.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Returns true when a normalised (lowercased, trailing-punctuation-stripped)
+ * heading text looks like a "Steps" heading.
+ * Accepted forms: steps, step, step(s).
+ */
+export declare function isStepsHeading(text: string): boolean;
 export declare const isEmptyParagraph: (b: any) => boolean;
 /**
  * Check whether a step or snippet can be inserted at / after the given block.

package/package/editor/blocks/step.js

@@ -43,6 +43,14 @@ const writeStepViewMode = (mode) => {
         //
     }
 };
+/**
+ * Returns true when a normalised (lowercased, trailing-punctuation-stripped)
+ * heading text looks like a "Steps" heading.
+ * Accepted forms: steps, step, step(s).
+ */
+export function isStepsHeading(text) {
+    return /^step(s|\(s\))?$/.test(text);
+}
 export const isEmptyParagraph = (b) => b.type === "paragraph" &&
     (!Array.isArray(b.content) ||
         b.content.length === 0 ||
@@ -71,7 +79,7 @@ export function canInsertStepOrSnippet(editor, referenceBlockId) {
                 .trim()
                 .toLowerCase()
                 .replace(/[:\-–—]$/, "");
-            return text === "steps";
+            return isStepsHeading(text);
         }
         return false;
     }
@@ -148,7 +156,7 @@ export const stepBlock = createReactBlockSpec({
                         .trim()
                         .toLowerCase()
                         .replace(/[:\-–—]$/, "");
-                    return text === "steps";
+                    return isStepsHeading(text);
                 }
                 return false;
             }

package/package/editor/customMarkdownConverter.js

@@ -1,4 +1,5 @@
 import { isLinkInlineContent, isStyledTextInlineContent, } from "@blocknote/core";
+import { isStepsHeading } from "./blocks/step";
 const BASE_BLOCK_PROPS = {
     textAlignment: "left",
     textColor: "default",
@@ -257,6 +258,14 @@ function serializeBlock(block, ctx, orderedIndex, stepIndex) {
             lines.push(...serializeChildren(block, ctx));
             return lines;
         }
+        case "image": {
+            const url = block.props.url || "";
+            const caption = block.props.caption || "";
+            if (url) {
+                lines.push(`![${caption}](${url})`);
+            }
+            return flattenWithBlankLine(lines, true);
+        }
         case "testStep":
         case "snippet": {
             const isSnippet = block.type === "snippet";
@@ -455,9 +464,9 @@ function serializeBlocks(blocks, ctx) {
 export function blocksToMarkdown(blocks) {
     const lines = serializeBlocks(blocks, { listDepth: 0, insideQuote: false });
     const cleaned = lines
-        // Collapse more than two blank lines into just two for readability.
+        // Collapse excessive blank lines but preserve one extra for empty paragraphs.
         .join("\n")
-        .replace(/\n{3,}/g, "\n\n")
+        .replace(/\n{4,}/g, "\n\n\n")
         .trimEnd();
     return cleaned;
 }
@@ -1086,12 +1095,6 @@ export function fixMalformedImageBlocks(blocks) {
     while (i < blocks.length) {
         const current = blocks[i];
         const next = blocks[i + 1];
-        // Skip empty paragraphs
-        if (current.type === "paragraph" &&
-            (!current.content || !Array.isArray(current.content) || current.content.length === 0)) {
-            i += 1;
-            continue;
-        }
         // Check if current is a paragraph with just "!" - this is definitely a malformed image
         if (current.type === "paragraph" &&
             current.content &&
@@ -1133,7 +1136,7 @@ export function fixMalformedImageBlocks(blocks) {
     return result;
 }
 export function markdownToBlocks(markdown) {
-    var _a, _b;
+    var _a, _b, _c;
     const normalized = markdown.replace(/\r\n/g, "\n");
     const lines = normalized.split("\n");
     const blocks = [];
@@ -1143,6 +1146,16 @@ export function markdownToBlocks(markdown) {
         const line = lines[index];
         if (!line.trim()) {
             index += 1;
+            // Count consecutive blank lines
+            let blankCount = 1;
+            while (index < lines.length && !lines[index].trim()) {
+                blankCount++;
+                index++;
+            }
+            // Create empty paragraph for each extra blank line beyond the first
+            for (let i = 1; i < blankCount; i++) {
+                blocks.push({ type: "paragraph", content: [], children: [] });
+            }
             continue;
         }
         const snippetWrapper = parseSnippetWrapper(lines, index);
@@ -1171,7 +1184,7 @@ export function markdownToBlocks(markdown) {
             const headingLevel = (_b = (_a = headingBlock.props) === null || _a === void 0 ? void 0 : _a.level) !== null && _b !== void 0 ? _b : 3;
             const headingText = inlineContentToPlainText(headingBlock.content);
             const normalizedHeading = headingText.trim().toLowerCase();
-            if (normalizedHeading.replace(/[:\-–—]$/, "") === "steps") {
+            if (isStepsHeading(normalizedHeading.replace(/[:\-–—]$/, ""))) {
                 stepsHeadingLevel = headingLevel;
             }
             else if (stepsHeadingLevel !== null &&
@@ -1202,11 +1215,33 @@ export function markdownToBlocks(markdown) {
             index = nextIndex;
             continue;
         }
+        const imageMatch = line.trim().match(/^!\[([^\]]*)\]\(([^)]+)\)$/);
+        if (imageMatch) {
+            blocks.push({
+                type: "image",
+                props: {
+                    url: imageMatch[2],
+                    caption: imageMatch[1] || "",
+                    name: "",
+                },
+                children: [],
+            });
+            index += 1;
+            continue;
+        }
         const paragraph = parseParagraph(lines, index);
         blocks.push(paragraph.block);
         index = paragraph.nextIndex;
     }
-    return fixMalformedImageBlocks(blocks);
+    // Insert empty paragraphs between consecutive headings so users can type between them
+    const result = [];
+    for (let i = 0; i < blocks.length; i++) {
+        result.push(blocks[i]);
+        if (blocks[i].type === "heading" && ((_c = blocks[i + 1]) === null || _c === void 0 ? void 0 : _c.type) === "heading") {
+            result.push({ type: "paragraph", content: [], children: [] });
+        }
+    }
+    return fixMalformedImageBlocks(result);
 }
 function splitTableRow(line) {
     let value = line.trim();

package/package/index.d.ts

@@ -1,5 +1,5 @@
 export { customSchema, type CustomSchema, type CustomBlock, type CustomEditor, } from "./editor/customSchema";
-export { stepBlock } from "./editor/blocks/step";
+export { stepBlock, canInsertStepOrSnippet, isStepsHeading } from "./editor/blocks/step";
 export { snippetBlock } from "./editor/blocks/snippet";
 export { markdownToHtml, htmlToMarkdown } from "./editor/blocks/markdown";
 export { blocksToMarkdown, markdownToBlocks, type CustomEditorBlock, type CustomPartialBlock, } from "./editor/customMarkdownConverter";

package/package/index.js

@@ -1,5 +1,5 @@
 export { customSchema, } from "./editor/customSchema";
-export { stepBlock } from "./editor/blocks/step";
+export { stepBlock, canInsertStepOrSnippet, isStepsHeading } from "./editor/blocks/step";
 export { snippetBlock } from "./editor/blocks/snippet";
 export { markdownToHtml, htmlToMarkdown } from "./editor/blocks/markdown";
 export { blocksToMarkdown, markdownToBlocks, } from "./editor/customMarkdownConverter";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testomatio-editor-blocks",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "description": "Custom BlockNote schema, markdown conversion helpers, and UI for Testomatio-style test cases and steps.",
   "type": "module",
   "main": "./package/index.js",

package/src/editor/blocks/snippet.tsx

@@ -200,16 +200,21 @@ export const snippetBlock = createReactBlockSpec(
               onSelect={handleSnippetSelect}
             />
           </div>
-          {isSnippetSelected && snippetData && (
-            <div
-              className="bn-snippet__content"
-              dangerouslySetInnerHTML={{
-                __html: snippetData
-                  .replace(/&/g, "&amp;")
-                  .replace(/</g, "&lt;")
-                  .replace(/>/g, "&gt;"),
-              }}
-            />
+          {isSnippetSelected && (
+            <div className="bn-snippet__content">
+              {snippetData ? (
+                <span
+                  dangerouslySetInnerHTML={{
+                    __html: snippetData
+                      .replace(/&/g, "&amp;")
+                      .replace(/</g, "&lt;")
+                      .replace(/>/g, "&gt;"),
+                  }}
+                />
+              ) : (
+                <span className="bn-snippet__empty">No content here. Please update the snippet.</span>
+              )}
+            </div>
           )}
         </div>
       );

package/src/editor/blocks/step.tsx

@@ -47,6 +47,15 @@ const writeStepViewMode = (mode: StepViewMode) => {
   }
 };
 
+/**
+ * Returns true when a normalised (lowercased, trailing-punctuation-stripped)
+ * heading text looks like a "Steps" heading.
+ * Accepted forms: steps, step, step(s).
+ */
+export function isStepsHeading(text: string): boolean {
+  return /^step(s|\(s\))?$/.test(text);
+}
+
 export const isEmptyParagraph = (b: any): boolean =>
   b.type === "paragraph" &&
   (!Array.isArray(b.content) ||
@@ -80,7 +89,7 @@ export function canInsertStepOrSnippet(
         .trim()
         .toLowerCase()
         .replace(/[:\-–—]$/, "");
-      return text === "steps";
+      return isStepsHeading(text);
     }
     return false;
   }
@@ -162,7 +171,7 @@ export const stepBlock = createReactBlockSpec(
               .trim()
               .toLowerCase()
               .replace(/[:\-–—]$/, "");
-            return text === "steps";
+            return isStepsHeading(text);
           }
           return false;
         }

package/src/editor/customMarkdownConverter.test.ts

@@ -863,6 +863,40 @@ describe("markdownToBlocks", () => {
     ]);
   });
 
+  it("parses steps under a 'Step' heading (singular)", () => {
+    const markdown = ["## Step", "", "* Open the app", "* Click login"].join("\n");
+    const blocks = markdownToBlocks(markdown);
+    const stepBlocks = blocks.filter((block) => block.type === "testStep");
+    expect(stepBlocks).toHaveLength(2);
+    expect(stepBlocks[0].props).toMatchObject({ stepTitle: "Open the app" });
+    expect(stepBlocks[1].props).toMatchObject({ stepTitle: "Click login" });
+  });
+
+  it("parses steps under a 'Step(s)' heading", () => {
+    const markdown = ["# Step(s)", "", "1. First step", "2. Second step"].join("\n");
+    const blocks = markdownToBlocks(markdown);
+    const stepBlocks = blocks.filter((block) => block.type === "testStep");
+    expect(stepBlocks).toHaveLength(2);
+    expect(stepBlocks[0].props).toMatchObject({ stepTitle: "First step", listStyle: "ordered" });
+    expect(stepBlocks[1].props).toMatchObject({ stepTitle: "Second step", listStyle: "ordered" });
+  });
+
+  it("parses steps under an h4 'step' heading (lowercase)", () => {
+    const markdown = ["#### step", "", "* Do something"].join("\n");
+    const blocks = markdownToBlocks(markdown);
+    const stepBlocks = blocks.filter((block) => block.type === "testStep");
+    expect(stepBlocks).toHaveLength(1);
+    expect(stepBlocks[0].props).toMatchObject({ stepTitle: "Do something" });
+  });
+
+  it("parses steps under a 'Step:' heading with trailing colon", () => {
+    const markdown = ["### Step:", "", "* Verify output"].join("\n");
+    const blocks = markdownToBlocks(markdown);
+    const stepBlocks = blocks.filter((block) => block.type === "testStep");
+    expect(stepBlocks).toHaveLength(1);
+    expect(stepBlocks[0].props).toMatchObject({ stepTitle: "Verify output" });
+  });
+
   it("handles multiple steps with expected results without extra asterisks", () => {
     const markdown = [
       "### Preconditions",
@@ -1173,36 +1207,17 @@ describe("markdownToBlocks", () => {
 
     const blocks = markdownToBlocks(markdown);
 
-    // Find the paragraph blocks that contain the images (links)
-    const imageBlocks = blocks.filter(block =>
-      block.type === "paragraph" &&
-      block.content &&
-      Array.isArray(block.content) &&
-      block.content.some((item: any) =>
-        (item.type === "text" && item.text === "!") ||
-        (item.type === "link" && item.href && item.href.includes("/attachments/"))
-      )
-    );
+    // Find the image blocks
+    const imageBlocks = blocks.filter(block => block.type === "image");
 
-    // Should have two paragraph blocks with images
+    // Should have two image blocks
     expect(imageBlocks.length).toBe(2);
 
-    // Check that both image links are properly parsed
-    const imageLinks: any[] = [];
-    imageBlocks.forEach(block => {
-      if (block.content && Array.isArray(block.content)) {
-        const link = (block.content as any[]).find(item => item.type === "link");
-        if (link) {
-          imageLinks.push(link);
-        }
-      }
-    });
-
-    expect(imageLinks).toHaveLength(2);
-    expect(imageLinks[0].href).toBe("/attachments/se2n8jaGon.png");
-    expect(imageLinks[0].content).toEqual([{ type: "text", text: "logs", styles: {} }]);
-    expect(imageLinks[1].href).toBe("/attachments/p5DgklVeMg.png");
-    expect(imageLinks[1].content).toEqual([{ type: "text", text: "", styles: {} }]);
+    // Check image block props
+    expect((imageBlocks[0].props as any).url).toBe("/attachments/se2n8jaGon.png");
+    expect((imageBlocks[0].props as any).caption).toBe("logs");
+    expect((imageBlocks[1].props as any).url).toBe("/attachments/p5DgklVeMg.png");
+    expect((imageBlocks[1].props as any).caption).toBe("");
 
     // Test round-trip conversion
     const roundTripMarkdown = blocksToMarkdown(blocks as CustomEditorBlock[]);
@@ -1311,47 +1326,19 @@ describe("markdownToBlocks", () => {
 
     const blocks = markdownToBlocks(markdown);
 
-    // Find image paragraphs
-    const imageParagraphs = blocks.filter(block =>
-      block.type === "paragraph" &&
-      block.content &&
-      Array.isArray(block.content) &&
-      block.content.some((item: any) => item.type === "link")
-    );
+    // Find image blocks
+    const imageBlocks = blocks.filter(block => block.type === "image");
 
-    // Should have exactly 2 image paragraphs
-    expect(imageParagraphs).toHaveLength(2);
+    // Should have exactly 2 image blocks
+    expect(imageBlocks).toHaveLength(2);
 
     // First image with alt text
-    expect(imageParagraphs[0].content).toContainEqual({
-      type: "text",
-      text: "!",
-      styles: {}
-    });
-    expect(imageParagraphs[0].content).toContainEqual({
-      type: "link",
-      href: "/attachments/se2n8jaGon.png",
-      content: [{ type: "text", text: "logs", styles: {} }]
-    });
+    expect((imageBlocks[0].props as any).url).toBe("/attachments/se2n8jaGon.png");
+    expect((imageBlocks[0].props as any).caption).toBe("logs");
 
     // Second image without alt text
-    expect(imageParagraphs[1].content).toContainEqual({
-      type: "text",
-      text: "!",
-      styles: {}
-    });
-    expect(imageParagraphs[1].content).toContainEqual({
-      type: "link",
-      href: "/attachments/p5DgklVeMg.png",
-      content: [{ type: "text", text: "", styles: {} }]
-    });
-
-    // No extra empty paragraphs
-    const emptyParagraphs = blocks.filter(block =>
-      block.type === "paragraph" &&
-      (!block.content || block.content.length === 0)
-    );
-    expect(emptyParagraphs).toHaveLength(0);
+    expect((imageBlocks[1].props as any).url).toBe("/attachments/p5DgklVeMg.png");
+    expect((imageBlocks[1].props as any).caption).toBe("");
 
     // Test round-trip conversion
     const roundTripMarkdown = blocksToMarkdown(blocks as CustomEditorBlock[]);
@@ -1374,18 +1361,9 @@ describe("markdownToBlocks", () => {
 
     const blocks = markdownToBlocks(markdown);
 
-    // Should have exactly 2 image paragraphs, no empty paragraphs
-    const imageParagraphs = blocks.filter(block =>
-      block.type === "paragraph" &&
-      block.content &&
-      Array.isArray(block.content) &&
-      block.content.some((item: any) => item.type === "link")
-    );
-
-    const emptyParagraphs = blocks.filter(block =>
-      block.type === "paragraph" &&
-      (!block.content || block.content.length === 0)
-    );
+    // Should have exactly 2 image blocks
+    const imageBlocks = blocks.filter(block => block.type === "image");
+    expect(imageBlocks).toHaveLength(2);
 
     // Check for malformed image blocks (paragraphs with just "!" but no link)
     const malformedBlocks = blocks.filter(block =>
@@ -1395,9 +1373,6 @@ describe("markdownToBlocks", () => {
       block.content.some((item: any) => item.type === "text" && item.text === "!") &&
       !block.content.some((item: any) => item.type === "link")
     );
-
-    expect(imageParagraphs).toHaveLength(2);
-    expect(emptyParagraphs).toHaveLength(0);
     expect(malformedBlocks).toHaveLength(0);
 
     // Test round-trip conversion
@@ -1489,8 +1464,8 @@ describe("markdownToBlocks", () => {
     // Apply the fixMalformedImageBlocks function
     const fixedBlocks = fixMalformedImageBlocks(malformedBlocks);
 
-    // Should have removed the malformed image blocks (both the "!" only block and the empty block)
-    expect(fixedBlocks.length).toBe(2);
+    // Should have removed the malformed "!" only block but kept the empty paragraph and image block
+    expect(fixedBlocks.length).toBe(3);
     expect(fixedBlocks[0].type).toBe("heading");
     expect(fixedBlocks[1].type).toBe("paragraph");
     expect(fixedBlocks[1].content).toContainEqual(
@@ -1499,6 +1474,8 @@ describe("markdownToBlocks", () => {
     expect(fixedBlocks[1].content).toContainEqual(
       { type: "link", href: "/attachments/se2n8jaGon.png", content: [{ type: "text", text: "logs", styles: {} }] }
     );
+    expect(fixedBlocks[2].type).toBe("paragraph");
+    expect(fixedBlocks[2].content).toHaveLength(0);
   });
 
   it("reproduces the exact Unsplash URL issue", () => {
@@ -1525,14 +1502,9 @@ describe("markdownToBlocks", () => {
     // Should have at least 3 blocks
     expect(blocks.length).toBeGreaterThanOrEqual(3);
 
-    // Should have at least one paragraph with content (images)
-    const imageBlocks = blocks.filter(b =>
-      b.type === "paragraph" &&
-      b.content &&
-      Array.isArray(b.content) &&
-      b.content.some((item: any) => item.type === "link")
-    );
-    expect(imageBlocks.length).toBeGreaterThan(0);
+    // Should have image blocks
+    const imageBlocks = blocks.filter(b => b.type === "image");
+    expect(imageBlocks.length).toBe(2);
 
     // Test round-trip conversion - check that we get the images back
     const roundTripMarkdown = blocksToMarkdown(blocks as CustomEditorBlock[]);

package/src/editor/customMarkdownConverter.ts

@@ -9,6 +9,7 @@ import type {
   Styles,
 } from "@blocknote/core";
 import type { customSchema } from "./customSchema";
+import { isStepsHeading } from "./blocks/step";
 
 // Types derived from the custom schema so the converter stays type-safe when the schema evolves.
 type Schema = typeof customSchema;
@@ -335,6 +336,14 @@ function serializeBlock(
       lines.push(...serializeChildren(block, ctx));
       return lines;
     }
+    case "image": {
+      const url = (block.props as any).url || "";
+      const caption = (block.props as any).caption || "";
+      if (url) {
+        lines.push(`![${caption}](${url})`);
+      }
+      return flattenWithBlankLine(lines, true);
+    }
     case "testStep":
     case "snippet": {
       const isSnippet = block.type === "snippet";
@@ -569,9 +578,9 @@ function serializeBlocks(blocks: CustomEditorBlock[], ctx: MarkdownContext): str
 export function blocksToMarkdown(blocks: CustomEditorBlock[]): string {
   const lines = serializeBlocks(blocks, { listDepth: 0, insideQuote: false });
   const cleaned = lines
-    // Collapse more than two blank lines into just two for readability.
+    // Collapse excessive blank lines but preserve one extra for empty paragraphs.
     .join("\n")
-    .replace(/\n{3,}/g, "\n\n")
+    .replace(/\n{4,}/g, "\n\n\n")
     .trimEnd();
 
   return cleaned;
@@ -1300,15 +1309,6 @@ export function fixMalformedImageBlocks(blocks: CustomPartialBlock[]): CustomPar
     const current = blocks[i];
     const next = blocks[i + 1];
 
-    // Skip empty paragraphs
-    if (
-      current.type === "paragraph" &&
-      (!current.content || !Array.isArray(current.content) || current.content.length === 0)
-    ) {
-      i += 1;
-      continue;
-    }
-
     // Check if current is a paragraph with just "!" - this is definitely a malformed image
     if (
       current.type === "paragraph" &&
@@ -1371,6 +1371,16 @@ export function markdownToBlocks(markdown: string): CustomPartialBlock[] {
     const line = lines[index];
     if (!line.trim()) {
       index += 1;
+      // Count consecutive blank lines
+      let blankCount = 1;
+      while (index < lines.length && !lines[index].trim()) {
+        blankCount++;
+        index++;
+      }
+      // Create empty paragraph for each extra blank line beyond the first
+      for (let i = 1; i < blankCount; i++) {
+        blocks.push({ type: "paragraph", content: [], children: [] } as CustomPartialBlock);
+      }
       continue;
     }
 
@@ -1404,7 +1414,7 @@ export function markdownToBlocks(markdown: string): CustomPartialBlock[] {
       const headingText = inlineContentToPlainText(headingBlock.content as any);
       const normalizedHeading = headingText.trim().toLowerCase();
 
-      if (normalizedHeading.replace(/[:\-–—]$/, "") === "steps") {
+      if (isStepsHeading(normalizedHeading.replace(/[:\-–—]$/, ""))) {
         stepsHeadingLevel = headingLevel;
       } else if (
         stepsHeadingLevel !== null &&
@@ -1447,12 +1457,36 @@ export function markdownToBlocks(markdown: string): CustomPartialBlock[] {
       continue;
     }
 
+    const imageMatch = line.trim().match(/^!\[([^\]]*)\]\(([^)]+)\)$/);
+    if (imageMatch) {
+      blocks.push({
+        type: "image",
+        props: {
+          url: imageMatch[2],
+          caption: imageMatch[1] || "",
+          name: "",
+        },
+        children: [],
+      } as CustomPartialBlock);
+      index += 1;
+      continue;
+    }
+
     const paragraph = parseParagraph(lines, index);
     blocks.push(paragraph.block);
     index = paragraph.nextIndex;
   }
 
-  return fixMalformedImageBlocks(blocks);
+  // Insert empty paragraphs between consecutive headings so users can type between them
+  const result: CustomPartialBlock[] = [];
+  for (let i = 0; i < blocks.length; i++) {
+    result.push(blocks[i]);
+    if (blocks[i].type === "heading" && blocks[i + 1]?.type === "heading") {
+      result.push({ type: "paragraph", content: [], children: [] } as CustomPartialBlock);
+    }
+  }
+
+  return fixMalformedImageBlocks(result);
 }
 
 function splitTableRow(line: string): string[] {

package/src/index.ts

@@ -4,7 +4,7 @@ export {
   type CustomBlock,
   type CustomEditor,
 } from "./editor/customSchema";
-export { stepBlock } from "./editor/blocks/step";
+export { stepBlock, canInsertStepOrSnippet, isStepsHeading } from "./editor/blocks/step";
 export { snippetBlock } from "./editor/blocks/snippet";
 export { markdownToHtml, htmlToMarkdown } from "./editor/blocks/markdown";