@readme/markdown 15.6.0 → 15.7.1

package/dist/example/components.d.ts

@@ -8,5 +8,6 @@ declare const components: {
     Snake_case_component: string;
     Card: string;
     Grid: string;
+    ExpressionPropCodeBlock: string;
 };
 export default components;

package/dist/lib/micromark/mdx-component/continuation-checks.d.ts

@@ -1,3 +1,2 @@
 import type { Construct } from 'micromark-util-types';
-export declare const nonLazyContinuationStart: Construct;
 export declare const markupOnlyContinuation: Construct;

package/dist/main.js

@@ -76043,31 +76043,11 @@ const HTML_VOID_ELEMENTS = new Set([
 
 
 /**
- * Partial constructs the `mdxComponent` tokenizer runs via `effects.check` to
- * decide whether the next line continues the block. They live here (not in
- * `syntax.ts`) because they hold none of `createTokenize`'s closure state — each
+ * Partial construct the `mdxComponent` tokenizer runs via `effects.check` to
+ * decide whether the next line continues the block. It lives here (not in
+ * `syntax.ts`) because it holds none of `createTokenize`'s closure state — it
  * is a self-contained, single-line lookahead.
  */
-function continuation_checks_tokenizeNonLazyContinuationStart(effects, ok, nok) {
-    // eslint-disable-next-line @typescript-eslint/no-this-alias
-    const self = this;
-    return start;
-    function start(code) {
-        if (markdownLineEnding(code)) {
-            effects.enter(types.lineEnding);
-            effects.consume(code);
-            effects.exit(types.lineEnding);
-            return after;
-        }
-        return nok(code);
-    }
-    function after(code) {
-        if (self.parser.lazy[self.now().line]) {
-            return nok(code);
-        }
-        return ok(code);
-    }
-}
 // A markup-only line opens with a tag (`<x`/`</x`) and ends (ignoring trailing
 // spaces) at a `>`. That distinguishes a structural continuation like
 // `<span>b</span></div>` from a paragraph like `<b>Note:</b> read *this*`.
@@ -76108,12 +76088,6 @@ function tokenizeMarkupOnlyContinuation(effects, ok, nok) {
         return scanToLineEnd;
     }
 }
-// A line ending whose next line isn't a lazy paragraph continuation. Checked so a
-// component body's blank/continuation lines aren't stolen by an interrupted paragraph.
-const continuation_checks_nonLazyContinuationStart = {
-    tokenize: continuation_checks_tokenizeNonLazyContinuationStart,
-    partial: true,
-};
 // Lookahead for `plainClaimLineStart`: is this line markup-only, or a paragraph
 // that merely starts with a tag? Run via `effects.check` so it never consumes.
 const markupOnlyContinuation = {
@@ -76529,14 +76503,7 @@ function syntax_createTokenize(mode) {
         }
         // Continuation for multi-line opening tags
         function openTagContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, openTagContinuationNonLazy, continuationAfter)(code);
-        }
-        function openTagContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types.lineEnding);
-            effects.consume(code);
-            effects.exit(types.lineEnding);
-            return openTagContinuationBefore;
+            return continueOnNextLine(code, openTagContinuationBefore);
         }
         function openTagContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -76654,14 +76621,7 @@ function syntax_createTokenize(mode) {
             return inFencedCode;
         }
         function fencedCodeContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, fencedCodeContinuationNonLazy, continuationAfter)(code);
-        }
-        function fencedCodeContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types.lineEnding);
-            effects.consume(code);
-            effects.exit(types.lineEnding);
-            return fencedCodeContinuationBefore;
+            return continueOnNextLine(code, fencedCodeContinuationBefore);
         }
         function fencedCodeContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -76878,14 +76838,7 @@ function syntax_createTokenize(mode) {
         }
         // ── Body continuation (line endings) ───────────────────────────────────
         function bodyContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, bodyContinuationNonLazy, continuationAfter)(code);
-        }
-        function bodyContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types.lineEnding);
-            effects.consume(code);
-            effects.exit(types.lineEnding);
-            return bodyContinuationBefore;
+            return continueOnNextLine(code, bodyContinuationBefore);
         }
         function bodyContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -76954,13 +76907,18 @@ function syntax_createTokenize(mode) {
             pendingBlankLine = false;
             return bodyLineStart(code);
         }
-        // ── Shared lazy continuation failure ───────────────────────────────────
-        function continuationAfter(code) {
-            if (code === null) {
+        // ── Shared line-ending continuation ────────────────────────────────────
+        // Consumes one line ending and resumes at `nextLine`. Lazy lines (under-indented
+        // under a list item or blockquote) continue too: a claim only ends at its closing
+        // tag, and an unclosed one fails whole at EOF instead of leaving a truncated opener (CX-3940).
+        function continueOnNextLine(code, nextLine) {
+            if (!markdownLineEnding(code))
                 return nok(code);
-            }
-            effects.exit('mdxComponent');
-            return ok(code);
+            sawLineEnding = true;
+            effects.enter(types.lineEnding);
+            effects.consume(code);
+            effects.exit(types.lineEnding);
+            return nextLine;
         }
     };
 }
@@ -81088,6 +81046,8 @@ const processTableNode = (node, index, parent, documentPosition) => {
         type: 'table',
         position,
         children,
+        // Remember the author's spelling so the serializer can write `<table>` back instead of `<Table>`
+        ...(node.name === 'table' && { data: { lowercaseTable: true } }),
     };
     parent.children[index] = mdNode;
 };
@@ -96690,7 +96650,7 @@ const rehypeToc = ({ components = {} }) => {
         });
     };
 };
-const MAX_DEPTH = 2;
+const MAX_DEPTH = 3;
 /**
  * Get the depth of a heading element based on its tag name.
  *
@@ -104798,7 +104758,7 @@ const parseMdChildren = (value, safeMode) => {
     // Promote nested wrappers bottom-up so an outer wrapper sees markdown buried in a
     // child claimed whole (e.g. `<li>` in `<ol>`) before its containsMarkdownConstruct check (RM-17560).
     // eslint-disable-next-line @typescript-eslint/no-use-before-define -- mutually recursive; hoisted decl, safe at runtime
-    promoteComponentBlocks(parsed, safeMode, null);
+    promoteComponentBlocks(parsed, safeMode, reparseSource);
     const children = parsed.children || [];
     // These children root a new coordinate space: their offsets index into `reparseSource`.
     stampReparseSource(children, reparseSource);
@@ -104817,23 +104777,26 @@ const parseSibling = (parent, index, sibling, safeMode, promoted) => {
     }
 };
 // Ends the position at `consumedLength` so the component doesn't claim trailing
-// content the tokenizer swallowed into the same html node.
-const positionEndingAtConsumed = (nodePosition, value, consumedLength) => {
+// content the tokenizer swallowed into the same html node. Measured against the source
+// when available: each value line is its source line minus the container prefix
+// (list indent, `> `) micromark stripped, so those prefixes are counted back in.
+const positionEndingAtConsumed = (nodePosition, value, consumedLength, source) => {
     if (!nodePosition?.start)
         return nodePosition;
-    return { start: nodePosition.start, end: pointAfter(nodePosition.start, value.slice(0, consumedLength)) };
-};
-// Like `positionEndingAtConsumed`, but measures against the original source so
-// blockquote/list prefixes stripped from the html node's value are counted.
-const positionEndingAtClosingTagInSource = (nodePosition, closingTag, source) => {
-    if (!nodePosition?.start || !nodePosition.end)
-        return nodePosition;
-    const nodeSource = source.slice(nodePosition.start.offset, nodePosition.end.offset);
-    const closingTagOffset = nodeSource.lastIndexOf(closingTag);
-    if (closingTagOffset === -1)
-        return nodePosition;
-    const consumed = nodeSource.slice(0, closingTagOffset + closingTag.length);
-    return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumed) };
+    const consumedValue = value.slice(0, consumedLength);
+    const sourceLines = source?.slice(nodePosition.start.offset, nodePosition.end?.offset).split('\n');
+    const valueLines = value.split('\n');
+    if (!sourceLines || sourceLines.length !== valueLines.length) {
+        return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumedValue) };
+    }
+    const consumedLines = consumedValue.split('\n');
+    const lastLineIndex = consumedLines.length - 1;
+    const prefixWidth = sourceLines[lastLineIndex].length - valueLines[lastLineIndex].length;
+    const consumedSource = [
+        ...sourceLines.slice(0, lastLineIndex),
+        sourceLines[lastLineIndex].slice(0, prefixWidth + consumedLines[lastLineIndex].length),
+    ].join('\n');
+    return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumedSource) };
 };
 const createComponentNode = ({ tag, attributes, children, startPosition, endPosition, }) => ({
     type: 'mdxJsxFlowElement',
@@ -104940,16 +104903,18 @@ function promoteComponentBlocks(tree, safeMode, source) {
         const closingTagStr = `</${tag}>`;
         // Case 1: Self-closing tag
         if (selfClosing) {
+            const remainingContent = contentAfterTag.trim();
             const componentNode = createComponentNode({
                 tag,
                 attributes,
                 children: [],
                 startPosition: node.position,
-                // End at the self-closing tag, not at any trailing content.
-                endPosition: positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd),
+                // Without trailing content the whole node position is correct; with it, end at the tag.
+                endPosition: remainingContent
+                    ? positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd, source)
+                    : node.position,
             });
             substituteNodeWithMdxNode(parent, index, componentNode);
-            const remainingContent = contentAfterTag.trim();
             if (remainingContent) {
                 parseSibling(parent, index, remainingContent, safeMode, promoted);
             }
@@ -104988,14 +104953,10 @@ function promoteComponentBlocks(tree, safeMode, source) {
                     stampReparseSource(parsedChildren, soleParagraph.data.reparseSource);
                 unwrappedSoleParagraph = true;
             }
-            // Without trailing content the whole node position is correct. With it, end
-            // precisely at the closing tag — preferring source offsets when available (the
-            // node's value strips blockquote/list prefixes), else the consumed span.
+            // Without trailing content the whole node position is correct; with it, end at the closing tag.
             let endPosition = node.position;
             if (contentAfterClose) {
-                endPosition = source
-                    ? positionEndingAtClosingTagInSource(node.position, closingTagStr, source)
-                    : positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd + closingTagIndex + closingTagStr.length);
+                endPosition = positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd + closingTagIndex + closingTagStr.length, source);
             }
             const componentNode = createComponentNode({
                 tag,
@@ -107666,13 +107627,22 @@ const mdxishTablesToJsx = () => tree => {
             gfmCells.push([cell, normalized]);
             return undefined;
         });
-        if (!requiresJsxTable) {
+        const stayLowercase = table.data?.lowercaseTable === true;
+        // We transform to GFM tables if:
+        // 1. If it doesn't contain complex elements that the syntax can't represent
+        // 2. The original table is not lowercase HTML <table>, because we want to 
+        // preserve original tables as much as possible
+        if (!requiresJsxTable && !stayLowercase) {
             gfmCells.forEach(([cell, children]) => {
                 cell.children = children;
             });
             table.type = 'table';
             return;
         }
+        // Nothing to build a JSX table from; leave the empty node to the GFM stringifier.
+        const [headerRow, ...bodyRows] = table.children;
+        if (!headerRow)
+            return;
         visit(table, mdxish_tables_to_jsx_isTableCell, flattenBreaksToNewlines);
         const styles = table.align.map(mdxish_tables_to_jsx_alignToStyle);
         const head = {
@@ -107684,7 +107654,7 @@ const mdxishTablesToJsx = () => tree => {
                     attributes: [],
                     type: 'mdxJsxFlowElement',
                     name: 'tr',
-                    children: table.children[0].children.map((cell, cellIndex) => {
+                    children: headerRow.children.map((cell, cellIndex) => {
                         return {
                             attributes: [],
                             type: 'mdxJsxFlowElement',
@@ -107700,7 +107670,7 @@ const mdxishTablesToJsx = () => tree => {
             attributes: [],
             type: 'mdxJsxFlowElement',
             name: 'tbody',
-            children: table.children.splice(1).map(row => {
+            children: bodyRows.map(row => {
                 return {
                     attributes: [],
                     type: 'mdxJsxFlowElement',
@@ -107728,8 +107698,8 @@ const mdxishTablesToJsx = () => tree => {
         ];
         const jsx = {
             type: 'mdxJsxFlowElement',
-            name: 'Table',
-            attributes: table.align.find(a => a) ? attributes : [],
+            name: stayLowercase ? 'table' : 'Table',
+            attributes: !stayLowercase && table.align.find(a => a) ? attributes : [],
             children: [head, body],
         };
         parent.children[index] = jsx;

package/dist/main.node.js

@@ -96226,31 +96226,11 @@ const HTML_VOID_ELEMENTS = new Set([
 
 
 /**
- * Partial constructs the `mdxComponent` tokenizer runs via `effects.check` to
- * decide whether the next line continues the block. They live here (not in
- * `syntax.ts`) because they hold none of `createTokenize`'s closure state — each
+ * Partial construct the `mdxComponent` tokenizer runs via `effects.check` to
+ * decide whether the next line continues the block. It lives here (not in
+ * `syntax.ts`) because it holds none of `createTokenize`'s closure state — it
  * is a self-contained, single-line lookahead.
  */
-function continuation_checks_tokenizeNonLazyContinuationStart(effects, ok, nok) {
-    // eslint-disable-next-line @typescript-eslint/no-this-alias
-    const self = this;
-    return start;
-    function start(code) {
-        if (markdownLineEnding(code)) {
-            effects.enter(types_types.lineEnding);
-            effects.consume(code);
-            effects.exit(types_types.lineEnding);
-            return after;
-        }
-        return nok(code);
-    }
-    function after(code) {
-        if (self.parser.lazy[self.now().line]) {
-            return nok(code);
-        }
-        return ok(code);
-    }
-}
 // A markup-only line opens with a tag (`<x`/`</x`) and ends (ignoring trailing
 // spaces) at a `>`. That distinguishes a structural continuation like
 // `<span>b</span></div>` from a paragraph like `<b>Note:</b> read *this*`.
@@ -96291,12 +96271,6 @@ function tokenizeMarkupOnlyContinuation(effects, ok, nok) {
         return scanToLineEnd;
     }
 }
-// A line ending whose next line isn't a lazy paragraph continuation. Checked so a
-// component body's blank/continuation lines aren't stolen by an interrupted paragraph.
-const continuation_checks_nonLazyContinuationStart = {
-    tokenize: continuation_checks_tokenizeNonLazyContinuationStart,
-    partial: true,
-};
 // Lookahead for `plainClaimLineStart`: is this line markup-only, or a paragraph
 // that merely starts with a tag? Run via `effects.check` so it never consumes.
 const markupOnlyContinuation = {
@@ -96712,14 +96686,7 @@ function syntax_createTokenize(mode) {
         }
         // Continuation for multi-line opening tags
         function openTagContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, openTagContinuationNonLazy, continuationAfter)(code);
-        }
-        function openTagContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types_types.lineEnding);
-            effects.consume(code);
-            effects.exit(types_types.lineEnding);
-            return openTagContinuationBefore;
+            return continueOnNextLine(code, openTagContinuationBefore);
         }
         function openTagContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -96837,14 +96804,7 @@ function syntax_createTokenize(mode) {
             return inFencedCode;
         }
         function fencedCodeContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, fencedCodeContinuationNonLazy, continuationAfter)(code);
-        }
-        function fencedCodeContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types_types.lineEnding);
-            effects.consume(code);
-            effects.exit(types_types.lineEnding);
-            return fencedCodeContinuationBefore;
+            return continueOnNextLine(code, fencedCodeContinuationBefore);
         }
         function fencedCodeContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -97061,14 +97021,7 @@ function syntax_createTokenize(mode) {
         }
         // ── Body continuation (line endings) ───────────────────────────────────
         function bodyContinuationStart(code) {
-            return effects.check(continuation_checks_nonLazyContinuationStart, bodyContinuationNonLazy, continuationAfter)(code);
-        }
-        function bodyContinuationNonLazy(code) {
-            sawLineEnding = true;
-            effects.enter(types_types.lineEnding);
-            effects.consume(code);
-            effects.exit(types_types.lineEnding);
-            return bodyContinuationBefore;
+            return continueOnNextLine(code, bodyContinuationBefore);
         }
         function bodyContinuationBefore(code) {
             if (code === null || markdownLineEnding(code)) {
@@ -97137,13 +97090,18 @@ function syntax_createTokenize(mode) {
             pendingBlankLine = false;
             return bodyLineStart(code);
         }
-        // ── Shared lazy continuation failure ───────────────────────────────────
-        function continuationAfter(code) {
-            if (code === null) {
+        // ── Shared line-ending continuation ────────────────────────────────────
+        // Consumes one line ending and resumes at `nextLine`. Lazy lines (under-indented
+        // under a list item or blockquote) continue too: a claim only ends at its closing
+        // tag, and an unclosed one fails whole at EOF instead of leaving a truncated opener (CX-3940).
+        function continueOnNextLine(code, nextLine) {
+            if (!markdownLineEnding(code))
                 return nok(code);
-            }
-            effects.exit('mdxComponent');
-            return ok(code);
+            sawLineEnding = true;
+            effects.enter(types_types.lineEnding);
+            effects.consume(code);
+            effects.exit(types_types.lineEnding);
+            return nextLine;
         }
     };
 }
@@ -101271,6 +101229,8 @@ const processTableNode = (node, index, parent, documentPosition) => {
         type: 'table',
         position,
         children,
+        // Remember the author's spelling so the serializer can write `<table>` back instead of `<Table>`
+        ...(node.name === 'table' && { data: { lowercaseTable: true } }),
     };
     parent.children[index] = mdNode;
 };
@@ -116873,7 +116833,7 @@ const rehypeToc = ({ components = {} }) => {
         });
     };
 };
-const MAX_DEPTH = 2;
+const MAX_DEPTH = 3;
 /**
  * Get the depth of a heading element based on its tag name.
  *
@@ -124981,7 +124941,7 @@ const parseMdChildren = (value, safeMode) => {
     // Promote nested wrappers bottom-up so an outer wrapper sees markdown buried in a
     // child claimed whole (e.g. `<li>` in `<ol>`) before its containsMarkdownConstruct check (RM-17560).
     // eslint-disable-next-line @typescript-eslint/no-use-before-define -- mutually recursive; hoisted decl, safe at runtime
-    promoteComponentBlocks(parsed, safeMode, null);
+    promoteComponentBlocks(parsed, safeMode, reparseSource);
     const children = parsed.children || [];
     // These children root a new coordinate space: their offsets index into `reparseSource`.
     stampReparseSource(children, reparseSource);
@@ -125000,23 +124960,26 @@ const parseSibling = (parent, index, sibling, safeMode, promoted) => {
     }
 };
 // Ends the position at `consumedLength` so the component doesn't claim trailing
-// content the tokenizer swallowed into the same html node.
-const positionEndingAtConsumed = (nodePosition, value, consumedLength) => {
+// content the tokenizer swallowed into the same html node. Measured against the source
+// when available: each value line is its source line minus the container prefix
+// (list indent, `> `) micromark stripped, so those prefixes are counted back in.
+const positionEndingAtConsumed = (nodePosition, value, consumedLength, source) => {
     if (!nodePosition?.start)
         return nodePosition;
-    return { start: nodePosition.start, end: pointAfter(nodePosition.start, value.slice(0, consumedLength)) };
-};
-// Like `positionEndingAtConsumed`, but measures against the original source so
-// blockquote/list prefixes stripped from the html node's value are counted.
-const positionEndingAtClosingTagInSource = (nodePosition, closingTag, source) => {
-    if (!nodePosition?.start || !nodePosition.end)
-        return nodePosition;
-    const nodeSource = source.slice(nodePosition.start.offset, nodePosition.end.offset);
-    const closingTagOffset = nodeSource.lastIndexOf(closingTag);
-    if (closingTagOffset === -1)
-        return nodePosition;
-    const consumed = nodeSource.slice(0, closingTagOffset + closingTag.length);
-    return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumed) };
+    const consumedValue = value.slice(0, consumedLength);
+    const sourceLines = source?.slice(nodePosition.start.offset, nodePosition.end?.offset).split('\n');
+    const valueLines = value.split('\n');
+    if (!sourceLines || sourceLines.length !== valueLines.length) {
+        return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumedValue) };
+    }
+    const consumedLines = consumedValue.split('\n');
+    const lastLineIndex = consumedLines.length - 1;
+    const prefixWidth = sourceLines[lastLineIndex].length - valueLines[lastLineIndex].length;
+    const consumedSource = [
+        ...sourceLines.slice(0, lastLineIndex),
+        sourceLines[lastLineIndex].slice(0, prefixWidth + consumedLines[lastLineIndex].length),
+    ].join('\n');
+    return { start: nodePosition.start, end: pointAfter(nodePosition.start, consumedSource) };
 };
 const createComponentNode = ({ tag, attributes, children, startPosition, endPosition, }) => ({
     type: 'mdxJsxFlowElement',
@@ -125123,16 +125086,18 @@ function promoteComponentBlocks(tree, safeMode, source) {
         const closingTagStr = `</${tag}>`;
         // Case 1: Self-closing tag
         if (selfClosing) {
+            const remainingContent = contentAfterTag.trim();
             const componentNode = createComponentNode({
                 tag,
                 attributes,
                 children: [],
                 startPosition: node.position,
-                // End at the self-closing tag, not at any trailing content.
-                endPosition: positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd),
+                // Without trailing content the whole node position is correct; with it, end at the tag.
+                endPosition: remainingContent
+                    ? positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd, source)
+                    : node.position,
             });
             substituteNodeWithMdxNode(parent, index, componentNode);
-            const remainingContent = contentAfterTag.trim();
             if (remainingContent) {
                 parseSibling(parent, index, remainingContent, safeMode, promoted);
             }
@@ -125171,14 +125136,10 @@ function promoteComponentBlocks(tree, safeMode, source) {
                     stampReparseSource(parsedChildren, soleParagraph.data.reparseSource);
                 unwrappedSoleParagraph = true;
             }
-            // Without trailing content the whole node position is correct. With it, end
-            // precisely at the closing tag — preferring source offsets when available (the
-            // node's value strips blockquote/list prefixes), else the consumed span.
+            // Without trailing content the whole node position is correct; with it, end at the closing tag.
             let endPosition = node.position;
             if (contentAfterClose) {
-                endPosition = source
-                    ? positionEndingAtClosingTagInSource(node.position, closingTagStr, source)
-                    : positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd + closingTagIndex + closingTagStr.length);
+                endPosition = positionEndingAtConsumed(node.position, value, leadingWhitespace + openingTagEnd + closingTagIndex + closingTagStr.length, source);
             }
             const componentNode = createComponentNode({
                 tag,
@@ -127849,13 +127810,22 @@ const mdxishTablesToJsx = () => tree => {
             gfmCells.push([cell, normalized]);
             return undefined;
         });
-        if (!requiresJsxTable) {
+        const stayLowercase = table.data?.lowercaseTable === true;
+        // We transform to GFM tables if:
+        // 1. If it doesn't contain complex elements that the syntax can't represent
+        // 2. The original table is not lowercase HTML <table>, because we want to 
+        // preserve original tables as much as possible
+        if (!requiresJsxTable && !stayLowercase) {
             gfmCells.forEach(([cell, children]) => {
                 cell.children = children;
             });
             table.type = 'table';
             return;
         }
+        // Nothing to build a JSX table from; leave the empty node to the GFM stringifier.
+        const [headerRow, ...bodyRows] = table.children;
+        if (!headerRow)
+            return;
         visit(table, mdxish_tables_to_jsx_isTableCell, flattenBreaksToNewlines);
         const styles = table.align.map(mdxish_tables_to_jsx_alignToStyle);
         const head = {
@@ -127867,7 +127837,7 @@ const mdxishTablesToJsx = () => tree => {
                     attributes: [],
                     type: 'mdxJsxFlowElement',
                     name: 'tr',
-                    children: table.children[0].children.map((cell, cellIndex) => {
+                    children: headerRow.children.map((cell, cellIndex) => {
                         return {
                             attributes: [],
                             type: 'mdxJsxFlowElement',
@@ -127883,7 +127853,7 @@ const mdxishTablesToJsx = () => tree => {
             attributes: [],
             type: 'mdxJsxFlowElement',
             name: 'tbody',
-            children: table.children.splice(1).map(row => {
+            children: bodyRows.map(row => {
                 return {
                     attributes: [],
                     type: 'mdxJsxFlowElement',
@@ -127911,8 +127881,8 @@ const mdxishTablesToJsx = () => tree => {
         ];
         const jsx = {
             type: 'mdxJsxFlowElement',
-            name: 'Table',
-            attributes: table.align.find(a => a) ? attributes : [],
+            name: stayLowercase ? 'table' : 'Table',
+            attributes: !stayLowercase && table.align.find(a => a) ? attributes : [],
             children: [head, body],
         };
         parent.children[index] = jsx;