@scrider/formatter 1.2.0 → 1.3.1

package/dist/index.d.cts

@@ -1039,6 +1039,27 @@ declare const formulaFormat: Format<string>;
  */
 declare const imageFormat: Format<string>;
 
+/**
+ * Soft Line Break embed format
+ *
+ * Represents a "Shift+Enter" style line break that does NOT split the
+ * containing block (paragraph, list item, table cell, etc.). This is the
+ * Delta-level analogue of HTML `<br>` used as an inline line break and
+ * of the GFM "hard break" Markdown construct (two trailing spaces + `\n`).
+ *
+ * Delta:    `{ insert: { softBreak: true } }`
+ * HTML:     `<br data-scrider-embed>` (with the explicit marker so that
+ *           round-trip parsing can distinguish a soft break from the
+ *           placeholder `<br>` that appears inside an empty paragraph)
+ * Markdown: `  \n` (default GFM hard break) or inline `<br>` (configurable
+ *           via `softBreakStyle` option on `deltaToMarkdown`)
+ *
+ * Value is always `true` — the embed has no additional data.
+ *
+ * @see {@link https://github.github.com/gfm/#hard-line-breaks GFM hard line break}
+ */
+declare const softBreakFormat: Format<boolean>;
+
 /**
  * Video embed format
  *
@@ -1557,6 +1578,22 @@ interface DeltaToMarkdownOptions {
      * `render()` is used as HTML fallback in Markdown.
      */
     registry?: Registry;
+    /**
+     * Rendering style for `{ softBreak: true }` embeds (Phase 7 Part 0).
+     *
+     * - `'spaces'` (default): GFM-canonical hard break — two trailing spaces
+     *   followed by `\n` (`"  \n"`). Round-trips losslessly through remark.
+     * - `'html'`: inline `<br>` tag. Slightly more visible in source view
+     *   and immune to editor whitespace trimming. Recommended for the
+     *   LFM (LLM-Flavored Markdown) flavour exposed by the editor's
+     *   "source" toggle.
+     *
+     * Does not affect how soft breaks are rendered inside table cells —
+     * those always use inline `<br>` because GFM tables forbid raw `\n`.
+     *
+     * @default 'spaces'
+     */
+    softBreakStyle?: 'spaces' | 'html';
     /**
      * Strip trailing newlines from the final output.
      *
@@ -1779,4 +1816,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type SanitizeOptions, type TableBlockData, type TableColAlignType, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };
+export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type SanitizeOptions, type TableBlockData, type TableColAlignType, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.d.ts

@@ -1039,6 +1039,27 @@ declare const formulaFormat: Format<string>;
  */
 declare const imageFormat: Format<string>;
 
+/**
+ * Soft Line Break embed format
+ *
+ * Represents a "Shift+Enter" style line break that does NOT split the
+ * containing block (paragraph, list item, table cell, etc.). This is the
+ * Delta-level analogue of HTML `<br>` used as an inline line break and
+ * of the GFM "hard break" Markdown construct (two trailing spaces + `\n`).
+ *
+ * Delta:    `{ insert: { softBreak: true } }`
+ * HTML:     `<br data-scrider-embed>` (with the explicit marker so that
+ *           round-trip parsing can distinguish a soft break from the
+ *           placeholder `<br>` that appears inside an empty paragraph)
+ * Markdown: `  \n` (default GFM hard break) or inline `<br>` (configurable
+ *           via `softBreakStyle` option on `deltaToMarkdown`)
+ *
+ * Value is always `true` — the embed has no additional data.
+ *
+ * @see {@link https://github.github.com/gfm/#hard-line-breaks GFM hard line break}
+ */
+declare const softBreakFormat: Format<boolean>;
+
 /**
  * Video embed format
  *
@@ -1557,6 +1578,22 @@ interface DeltaToMarkdownOptions {
      * `render()` is used as HTML fallback in Markdown.
      */
     registry?: Registry;
+    /**
+     * Rendering style for `{ softBreak: true }` embeds (Phase 7 Part 0).
+     *
+     * - `'spaces'` (default): GFM-canonical hard break — two trailing spaces
+     *   followed by `\n` (`"  \n"`). Round-trips losslessly through remark.
+     * - `'html'`: inline `<br>` tag. Slightly more visible in source view
+     *   and immune to editor whitespace trimming. Recommended for the
+     *   LFM (LLM-Flavored Markdown) flavour exposed by the editor's
+     *   "source" toggle.
+     *
+     * Does not affect how soft breaks are rendered inside table cells —
+     * those always use inline `<br>` because GFM tables forbid raw `\n`.
+     *
+     * @default 'spaces'
+     */
+    softBreakStyle?: 'spaces' | 'html';
     /**
      * Strip trailing newlines from the final output.
      *
@@ -1779,4 +1816,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type SanitizeOptions, type TableBlockData, type TableColAlignType, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };
+export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type SanitizeOptions, type TableBlockData, type TableColAlignType, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.js

@@ -1915,7 +1915,13 @@ var EMBED_RENDERERS = {
     const id = typeof value === "string" ? value : String(value);
     return `<sup class="footnote-ref"><a href="#fn-${escapeHtml(id)}" id="fnref-${escapeHtml(id)}">[${escapeHtml(id)}]</a></sup>`;
   },
-  divider: () => "<hr>"
+  divider: () => "<hr>",
+  // Soft line break (Shift+Enter equivalent). Emitted with an explicit
+  // `data-scrider-embed` marker so that html-to-delta can distinguish this
+  // embed from the placeholder `<br>` that appears inside an empty
+  // paragraph (`<p><br></p>`) without relying solely on positional
+  // heuristics. See `soft-break.ts` for the format definition.
+  softBreak: () => "<br data-scrider-embed>"
 };
 var TAG_TO_INLINE_FORMAT = {
   strong: { format: "bold", value: true },
@@ -2153,6 +2159,33 @@ var imageFormat = {
   }
 };
 
+// src/schema/formats/embed/soft-break.ts
+var softBreakFormat = {
+  name: "softBreak",
+  scope: "embed",
+  normalize(value) {
+    return !!value;
+  },
+  validate(value) {
+    return value === true;
+  },
+  render() {
+    return "<br data-scrider-embed>";
+  },
+  match(element) {
+    if (element.tagName.toLowerCase() !== "br") return null;
+    if (!element.hasAttribute("data-scrider-embed")) return null;
+    return { value: true };
+  }
+  // NB: Markdown rendering is intentionally NOT implemented on the format
+  // itself. The choice between `"  \n"` (GFM spaces) and inline `<br>`
+  // depends on the caller-provided `softBreakStyle` option on
+  // `deltaToMarkdown`, so the converter handles it as a built-in special
+  // case instead of going through `Format.toMarkdown`. The Markdown side
+  // of the round-trip is symmetric: `markdownToDelta` recognises both
+  // `break` AST nodes and inline `<br>` HTML and emits this embed.
+};
+
 // src/schema/formats/embed/video.ts
 var videoFormat = {
   name: "video",
@@ -2255,6 +2288,7 @@ var defaultEmbedFormats = [
   videoFormat,
   formulaFormat,
   dividerFormat,
+  softBreakFormat,
   blockFormat,
   footnoteRefFormat
 ];
@@ -3085,7 +3119,12 @@ function htmlToDelta(html, options = {}) {
       return;
     }
     if (tagName === "br") {
-      context.pushNewline();
+      const hasMarker = node.hasAttribute("data-scrider-embed");
+      if (hasMarker || hasMeaningfulPrevSibling(node)) {
+        context.pushEmbed({ softBreak: true });
+      } else {
+        context.pushNewline();
+      }
       return;
     }
     processChildren(node);
@@ -3480,7 +3519,7 @@ function htmlToDelta(html, options = {}) {
     }
     const children2 = element.childNodes;
     const firstChild = children2[0];
-    const isBrOnlyParagraph = children2.length === 1 && firstChild !== void 0 && isElement(firstChild) && firstChild.tagName.toLowerCase() === "br";
+    const isBrOnlyParagraph = children2.length === 1 && firstChild !== void 0 && isElement(firstChild) && firstChild.tagName.toLowerCase() === "br" && !firstChild.hasAttribute("data-scrider-embed");
     if (!isBrOnlyParagraph) {
       processChildren(element);
     }
@@ -3519,6 +3558,23 @@ function normalizeText(text, pendingText, atLineStart) {
   }
   return text;
 }
+function hasMeaningfulPrevSibling(brNode) {
+  const parent = brNode.parentNode;
+  if (!parent) return false;
+  const children = parent.childNodes;
+  for (let i = 0; i < children.length; i++) {
+    const child = children[i];
+    if (!child) continue;
+    if (child === brNode) return false;
+    if (child.nodeType === NODE_TYPE.TEXT_NODE) {
+      const text = child.textContent ?? "";
+      if (text.trim().length > 0) return true;
+    } else if (isElement(child)) {
+      return true;
+    }
+  }
+  return false;
+}
 function findTagHandler(handlers, element, tagName) {
   const className = element.getAttribute("class");
   if (className) {
@@ -3655,6 +3711,7 @@ function deltaToMarkdown(delta, options = {}) {
     blockHandlers,
     prettyHtml = false,
     registry,
+    softBreakStyle = "spaces",
     trimTrailingNewlines = false
   } = options;
   const useLatexDelimiters = mathSyntax === "latex";
@@ -3671,7 +3728,9 @@ function deltaToMarkdown(delta, options = {}) {
     const isBlockquote = !!attrs.blockquote;
     if (typeof attrs["table-row"] === "number" && typeof attrs["table-col"] === "number") {
       const tableLines = collectTableLines2(lines, i);
-      result.push(renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters, registry));
+      result.push(
+        renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters, registry, softBreakStyle)
+      );
       result.push("");
       i += tableLines.length - 1;
       lastListType = null;
@@ -3687,7 +3746,16 @@ function deltaToMarkdown(delta, options = {}) {
       const codeLines = collectCodeBlock(lines, i);
       const language = getCodeBlockLanguage2(attrs);
       const code = codeLines.map(
-        (l) => renderLineContent2(l.ops, embedRenderers, true, false, blockHandlers, false, registry)
+        (l) => renderLineContent2(
+          l.ops,
+          embedRenderers,
+          true,
+          false,
+          blockHandlers,
+          false,
+          registry,
+          softBreakStyle
+        )
       ).join("\n");
       if (language === "math") {
         if (mathBlock === false) {
@@ -3737,7 +3805,8 @@ ${code}
       useLatexDelimiters,
       blockHandlers,
       prettyHtml,
-      registry
+      registry,
+      softBreakStyle
     );
     if (!content && !hasBlockFormat(attrs)) {
       result.push(preserveEmptyLines ? "<br>" : "");
@@ -3839,7 +3908,7 @@ function collectTableLines2(lines, startIndex) {
   }
   return result;
 }
-function renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters = false, registry) {
+function renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters = false, registry, softBreakStyle = "spaces") {
   const rows = /* @__PURE__ */ new Map();
   for (const line of tableLines) {
     const attrs = line.attributes;
@@ -3876,7 +3945,9 @@ function renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters = fa
   const mdLines = [];
   if (headerRows.length > 0) {
     for (const [, row] of headerRows) {
-      mdLines.push(renderMdRow(row.cells, maxCol, embedRenderers, useLatexDelimiters, registry));
+      mdLines.push(
+        renderMdRow(row.cells, maxCol, embedRenderers, useLatexDelimiters, registry, softBreakStyle)
+      );
     }
     mdLines.push(renderMdSeparator(maxCol, colAligns));
   } else {
@@ -3884,15 +3955,19 @@ function renderMarkdownTable(tableLines, embedRenderers, useLatexDelimiters = fa
     for (let col = 0; col <= maxCol; col++) {
       emptyRow.set(col, { ops: [] });
     }
-    mdLines.push(renderMdRow(emptyRow, maxCol, embedRenderers, useLatexDelimiters, registry));
+    mdLines.push(
+      renderMdRow(emptyRow, maxCol, embedRenderers, useLatexDelimiters, registry, softBreakStyle)
+    );
     mdLines.push(renderMdSeparator(maxCol, colAligns));
   }
   for (const [, row] of bodyRows) {
-    mdLines.push(renderMdRow(row.cells, maxCol, embedRenderers, useLatexDelimiters, registry));
+    mdLines.push(
+      renderMdRow(row.cells, maxCol, embedRenderers, useLatexDelimiters, registry, softBreakStyle)
+    );
   }
   return mdLines.join("\n");
 }
-function renderMdRow(cells, maxCol, embedRenderers, useLatexDelimiters = false, registry) {
+function renderMdRow(cells, maxCol, embedRenderers, useLatexDelimiters = false, registry, softBreakStyle = "spaces") {
   const parts = [];
   for (let col = 0; col <= maxCol; col++) {
     const cell = cells.get(col);
@@ -3903,7 +3978,10 @@ function renderMdRow(cells, maxCol, embedRenderers, useLatexDelimiters = false,
       useLatexDelimiters,
       void 0,
       false,
-      registry
+      registry,
+      softBreakStyle,
+      true
+      // inTableCell — softBreak must use <br>, never "  \n"
     ) : "";
     parts.push(content.replace(/\|/g, "\\|"));
   }
@@ -3932,7 +4010,7 @@ function getCodeBlockLanguage2(attributes) {
   }
   return void 0;
 }
-function renderLineContent2(ops, embedRenderers, inCodeBlock, useLatexDelimiters = false, blockHandlers, prettyHtml = false, registry) {
+function renderLineContent2(ops, embedRenderers, inCodeBlock, useLatexDelimiters = false, blockHandlers, prettyHtml = false, registry, softBreakStyle = "spaces", inTableCell = false) {
   let result = "";
   for (const op of ops) {
     const attrs = op.attributes;
@@ -3952,7 +4030,9 @@ function renderLineContent2(ops, embedRenderers, inCodeBlock, useLatexDelimiters
         useLatexDelimiters,
         blockHandlers,
         prettyHtml,
-        registry
+        registry,
+        softBreakStyle,
+        inTableCell
       );
     }
   }
@@ -3986,13 +4066,17 @@ function renderInlineText2(text, attributes) {
   }
   return result;
 }
-function renderEmbed2(embed, attributes, customRenderers, useLatexDelimiters = false, blockHandlers, prettyHtml = false, registry) {
+function renderEmbed2(embed, attributes, customRenderers, useLatexDelimiters = false, blockHandlers, prettyHtml = false, registry, softBreakStyle = "spaces", inTableCell = false) {
   const entries = Object.entries(embed);
   if (entries.length === 0) return "";
   const firstEntry = entries[0];
   if (!firstEntry) return "";
   const embedType = firstEntry[0];
   const embedValue = firstEntry[1];
+  if (embedType === "softBreak") {
+    if (inTableCell) return "<br>";
+    return softBreakStyle === "html" ? "<br>" : "  \n";
+  }
   if (embedType === "block" && blockHandlers) {
     const blockData = embedValue;
     if (blockData && typeof blockData.type === "string") {
@@ -4481,7 +4565,7 @@ function astToDelta(tree, customHandlers, mathBlock, mermaidBlock, plantumlBlock
         footnoteDefinitions.set(node.identifier ?? "", node);
         break;
       case "break":
-        context.pushNewline();
+        context.pushEmbed({ softBreak: true });
         break;
       case "html": {
         const htmlContent = node.value ?? "";
@@ -4787,8 +4871,8 @@ function astToDelta(tree, customHandlers, mathBlock, mermaidBlock, plantumlBlock
       context.pushNewline();
       return;
     }
-    if (/^<br\s*\/?>$/i.test(html)) {
-      context.pushNewline();
+    if (/^<br\b[^>]*\/?>$/i.test(html)) {
+      context.pushEmbed({ softBreak: true });
       return;
     }
   }
@@ -4938,6 +5022,7 @@ export {
   sizeFormat,
   slugify,
   slugifyWithDedup,
+  softBreakFormat,
   strikeFormat,
   subscriptFormat,
   superscriptFormat,