markdown-to-slack-blocks 1.4.0 → 1.5.0

package/README.md

@@ -181,3 +181,31 @@ const text = blocksToPlainText(blocks);
 ```
 
 The function walks the rendered blocks and returns a joined string that keeps list markers, quotes, tables (as `cell | cell` rows), mentions, dates (using the provided fallback or ISO string), and basic formatting markers where possible. The output is best-effort and is intended for concise fallbacks rather than full fidelity rendering.
+
+### Markdown rendering
+
+If you need a best-effort Markdown representation of an existing block array, use `blocksToMarkdown`:
+
+```typescript
+import { blocksToMarkdown } from 'markdown-to-slack-blocks';
+
+const markdown = blocksToMarkdown(blocks);
+// -> "# Title\n\nParagraph with **bold** text" or similar
+```
+
+If you want Slack IDs rendered back to visible mention names (which might be useful for LLMs), pass the inverse mention map:
+
+```typescript
+const markdown = blocksToMarkdown(blocks, {
+    mentions: {
+        users: { 'U123456': 'username' },
+        channels: { 'C123456': 'general' },
+        userGroups: { 'S123456': 'engineers' },
+        teams: { 'T123456': 'myteam' }
+    }
+});
+```
+
+With these options, mentions like `<@U123456>` or `<#C123456>` are rendered as `@username` and `#general` where possible. The same ID format validation applies to these reverse mention maps.
+
+The renderer converts `rich_text`, section `mrkdwn`, code blocks, quotes, lists, tables, images, and Slack entities back into normalized Markdown. Because Slack blocks do not preserve every detail of the original source, the output is canonicalized rather than byte-for-byte identical to the input, but it round-trips cleanly for this library's generated blocks.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { MarkdownToBlocksOptions } from "./types";
 export * from "./types";
-export { blocksToPlainText, splitBlocks, splitBlocksWithText, SplitBlocksOptions, SplitBlocksResult, } from "./splitter";
+export { blocksToMarkdown, blocksToPlainText, splitBlocks, splitBlocksWithText, SplitBlocksOptions, SplitBlocksResult, } from "./splitter";
 export declare function markdownToBlocks(markdown: string, options?: MarkdownToBlocksOptions): import("./types").Block[];
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIvD,cAAc,SAAS,CAAC;AACxB,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,6BAIjC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIvD,cAAc,SAAS,CAAC;AACxB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,6BAIjC"}

package/dist/index.js

@@ -14,13 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitBlocksWithText = exports.splitBlocks = exports.blocksToPlainText = void 0;
+exports.splitBlocksWithText = exports.splitBlocks = exports.blocksToPlainText = exports.blocksToMarkdown = void 0;
 exports.markdownToBlocks = markdownToBlocks;
 const parser_1 = require("./parser");
 const validator_1 = require("./validator");
 // Re-export types for consumers
 __exportStar(require("./types"), exports);
 var splitter_1 = require("./splitter");
+Object.defineProperty(exports, "blocksToMarkdown", { enumerable: true, get: function () { return splitter_1.blocksToMarkdown; } });
 Object.defineProperty(exports, "blocksToPlainText", { enumerable: true, get: function () { return splitter_1.blocksToPlainText; } });
 Object.defineProperty(exports, "splitBlocks", { enumerable: true, get: function () { return splitter_1.splitBlocks; } });
 Object.defineProperty(exports, "splitBlocksWithText", { enumerable: true, get: function () { return splitter_1.splitBlocksWithText; } });

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,KAAK,EAKL,uBAAuB,EAGvB,MAAM,SAAS,CAAC;AAmFjB,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACnC,KAAK,EAAE,CAiNT"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,KAAK,EAKL,uBAAuB,EAGvB,MAAM,SAAS,CAAC;AAyGjB,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACnC,KAAK,EAAE,CAiNT"}

package/dist/parser.js

@@ -24,12 +24,25 @@ function isListNode(node) {
 /**
  * Preprocess markdown to "unwrap" lists that are entirely wrapped in formatting.
  * For example: "**1. Item**" becomes "1. **Item**"
+ * Also handles heading-prefixed format-wrapped lists:
+ * "### **1. Item**" becomes "###\n1. **Item**"
  * This allows the markdown parser to recognize them as list items.
  */
 function preprocessMarkdown(markdown) {
     const lines = markdown.split("\n");
-    const processedLines = lines.map((line) => {
+    const processedLines = [];
+    for (const line of lines) {
         const trimmed = line.trim();
+        // Match heading-prefixed format-wrapped lists
+        // e.g. "### **1. Item**" or "## *- Item*"
+        const headingFormatWrappedListRegex = /^(#{1,6})\s+(\*\*|\*|_|~)(\d+\.|\*|-|\+)(\s+)(.*?)\2$/;
+        const headingMatch = trimmed.match(headingFormatWrappedListRegex);
+        if (headingMatch) {
+            const [_, _heading, format, marker, spaces, content] = headingMatch;
+            // Split into an empty line (to end the heading context) and a format-unwrapped list line
+            processedLines.push(`${marker}${spaces}${format}${content}${format}`);
+            continue;
+        }
         // Match patterns like **1. item**, *1. item*, ~1. item~, **- item**, etc.
         // Group 1: opening format (** or * or _ or ~)
         // Group 2: list marker (1. or - or * or +)
@@ -42,10 +55,11 @@ function preprocessMarkdown(markdown) {
             const [_, format, marker, spaces, content] = match;
             // Preserve leading whitespace of the original line
             const leadingWhitespace = line.match(/^\s*/)?.[0] || "";
-            return `${leadingWhitespace}${marker}${spaces}${format}${content}${format}`;
+            processedLines.push(`${leadingWhitespace}${marker}${spaces}${format}${content}${format}`);
+            continue;
         }
-        return line;
-    });
+        processedLines.push(line);
+    }
     return processedLines.join("\n");
 }
 function parseMarkdown(markdown, options = {}) {
@@ -382,9 +396,14 @@ function processTextNode(text, style, options) {
             elements.push(withStyle({ type: "channel", channel_id: channelId }));
         }
         else if (match[8]) {
-            // Team: <!subteam^ID>
-            const teamId = match[8];
-            elements.push(withStyle({ type: "team", team_id: teamId }));
+            // User Group / Team: <!subteam^ID>
+            const subteamId = match[8];
+            if (subteamId.startsWith("S")) {
+                elements.push(withStyle({ type: "usergroup", usergroup_id: subteamId }));
+            }
+            else {
+                elements.push(withStyle({ type: "team", team_id: subteamId }));
+            }
         }
         else if (match[10]) {
             // Date: <!date^...|...>

package/dist/splitter.d.ts

@@ -1,4 +1,4 @@
-import type { Block } from "./types";
+import type { Block, BlocksToMarkdownOptions } from "./types";
 export interface SplitBlocksOptions {
     /** Maximum number of blocks per message. Default: 40 */
     maxBlocks?: number;
@@ -22,6 +22,10 @@ export declare function splitBlocks(blocks: Block[], options?: SplitBlocksOption
  * Splits blocks and also returns a plain-text fallback for each batch, suitable for postMessage `text`.
  */
 export declare function splitBlocksWithText(blocks: Block[], options?: SplitBlocksOptions): SplitBlocksResult[];
+/**
+ * Renders a block array back into best-effort Markdown.
+ */
+export declare function blocksToMarkdown(blocks: Block[], options?: BlocksToMarkdownOptions): string;
 /**
  * Generates a lightweight plain-text fallback from a block batch.
  */

package/dist/splitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"splitter.d.ts","sourceRoot":"","sources":["../src/splitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,KAAK,EASL,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IAClC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;CAChB;AAMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC1B,KAAK,EAAE,EAAE,CAqFX;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC1B,iBAAiB,EAAE,CAMrB;AAmSD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA4GzD"}
+{"version":3,"file":"splitter.d.ts","sourceRoot":"","sources":["../src/splitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,KAAK,EACL,uBAAuB,EAcvB,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,kBAAkB;IAClC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;CAChB;AAMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC1B,KAAK,EAAE,EAAE,CAqFX;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC1B,iBAAiB,EAAE,CAMrB;AAmSD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,uBAAuB,GAC/B,MAAM,CAWR;AAkjBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA4GzD"}

package/dist/splitter.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitBlocks = splitBlocks;
 exports.splitBlocksWithText = splitBlocksWithText;
+exports.blocksToMarkdown = blocksToMarkdown;
 exports.blocksToPlainText = blocksToPlainText;
+const validator_1 = require("./validator");
 const DEFAULT_MAX_BLOCKS = 40;
 const DEFAULT_MAX_CHARACTERS = 12000;
 const DEFAULT_MAX_TEXT_SECTION_CHARACTERS = 3000;
@@ -332,6 +334,400 @@ function chunkString(str, limit) {
     }
     return chunks;
 }
+/**
+ * Renders a block array back into best-effort Markdown.
+ */
+function blocksToMarkdown(blocks, options) {
+    (0, validator_1.validateBlocksToMarkdownOptions)(options);
+    const parts = [];
+    for (const block of blocks) {
+        const rendered = renderBlockAsMarkdown(block, options).trim();
+        if (rendered)
+            parts.push(rendered);
+    }
+    return parts.join("\n\n");
+}
+function renderBlockAsMarkdown(block, options) {
+    switch (block.type) {
+        case "section":
+            return renderSectionBlockAsMarkdown(block, options);
+        case "header":
+            return `# ${block.text.text}`;
+        case "context":
+            return block.elements
+                .map((element) => element.type === "image"
+                ? renderImageElementAsMarkdown(element)
+                : renderTextObjectAsMarkdown(element, options))
+                .filter(Boolean)
+                .join(" ");
+        case "rich_text":
+            return renderRichTextBlockAsMarkdown(block, options);
+        case "divider":
+            return "---";
+        case "image":
+            return renderImageBlockAsMarkdown(block);
+        case "table":
+            return renderTableBlockAsMarkdown(block, options);
+        default:
+            return "";
+    }
+}
+function renderSectionBlockAsMarkdown(block, options) {
+    const parts = [];
+    const text = renderTextObjectAsMarkdown(block.text, options);
+    if (text)
+        parts.push(text);
+    if (block.fields?.length) {
+        const renderedFields = block.fields
+            .map((field) => renderTextObjectAsMarkdown(field, options))
+            .filter(Boolean)
+            .join("\n");
+        if (renderedFields)
+            parts.push(renderedFields);
+    }
+    if (isImageElement(block.accessory)) {
+        parts.push(renderImageElementAsMarkdown(block.accessory));
+    }
+    return parts.join("\n\n");
+}
+function renderTextObjectAsMarkdown(text, options) {
+    if (!text)
+        return "";
+    return text.type === "mrkdwn"
+        ? convertMrkdwnToMarkdown(text.text, options)
+        : text.text;
+}
+function renderRichTextBlockAsMarkdown(block, options) {
+    const heading = renderRichTextHeadingAsMarkdown(block);
+    if (heading)
+        return heading;
+    const rendered = block.elements
+        .map((element) => renderRichTextElementAsMarkdown(element, options))
+        .filter((part) => part.markdown.length > 0);
+    if (rendered.length === 0)
+        return "";
+    let markdown = rendered[0].markdown;
+    for (let index = 1; index < rendered.length; index++) {
+        const previous = rendered[index - 1];
+        const current = rendered[index];
+        const separator = previous.kind === "list" && current.kind === "list" ? "\n" : "\n\n";
+        markdown += separator + current.markdown;
+    }
+    return markdown;
+}
+function renderRichTextHeadingAsMarkdown(block) {
+    if (block.elements.length !== 1)
+        return "";
+    const [element] = block.elements;
+    if (element.type !== "rich_text_section" || element.elements.length !== 1) {
+        return "";
+    }
+    const [textElement] = element.elements;
+    if (textElement.type !== "text" ||
+        !textElement.style?.bold ||
+        textElement.style.italic ||
+        textElement.style.strike ||
+        textElement.style.code) {
+        return "";
+    }
+    return `### ${textElement.text}`;
+}
+function renderRichTextElementAsMarkdown(element, options) {
+    switch (element.type) {
+        case "rich_text_section":
+            return {
+                kind: "section",
+                markdown: renderRichTextSectionAsMarkdown(element, options),
+            };
+        case "rich_text_list":
+            return {
+                kind: "list",
+                markdown: renderRichTextListAsMarkdown(element, options),
+            };
+        case "rich_text_preformatted":
+            return {
+                kind: "preformatted",
+                markdown: renderRichTextPreformattedAsMarkdown(element, options),
+            };
+        case "rich_text_quote":
+            return {
+                kind: "quote",
+                markdown: renderRichTextQuoteAsMarkdown(element, options),
+            };
+        default:
+            return {
+                kind: "section",
+                markdown: "",
+            };
+    }
+}
+function renderRichTextSectionAsMarkdown(section, options) {
+    return section.elements
+        .map((element) => renderRichTextSectionElementAsMarkdown(element, options))
+        .join("");
+}
+function renderRichTextListAsMarkdown(list, options) {
+    const indentUnit = list.style === "ordered" ? "   " : "  ";
+    const indent = indentUnit.repeat(list.indent ?? 0);
+    const start = list.offset ?? 1;
+    return list.elements
+        .map((item, index) => {
+        const marker = list.style === "ordered" ? `${start + index}. ` : "- ";
+        const content = renderRichTextSectionAsMarkdown(item, options);
+        return indentMultilineMarkdown(`${indent}${marker}`, content);
+    })
+        .join("\n");
+}
+function renderRichTextPreformattedAsMarkdown(element, options) {
+    const text = element.elements
+        .map((item) => renderRichTextSectionElementAsMarkdown(item, options))
+        .join("");
+    return wrapFencedCodeBlock(text);
+}
+function renderRichTextQuoteAsMarkdown(element, options) {
+    return renderRichTextSectionAsMarkdown({
+        type: "rich_text_section",
+        elements: element.elements,
+    }, options)
+        .split("\n")
+        .map((line) => `> ${line}`)
+        .join("\n");
+}
+function renderRichTextSectionElementAsMarkdown(element, options) {
+    switch (element.type) {
+        case "text":
+            return applyMarkdownStyle(element.text, element.style);
+        case "link": {
+            const content = element.text && element.text.length > 0
+                ? `[${element.text}](<${element.url}>)`
+                : element.url;
+            return applyMarkdownStyle(content, element.style);
+        }
+        case "emoji":
+            return applyMarkdownStyle(`:${element.name}:`, element.style);
+        case "date": {
+            const fallback = element.fallback ?? new Date(element.timestamp * 1000).toISOString();
+            const content = `<!date^${element.timestamp}^${element.format}|${fallback}>`;
+            return applyMarkdownStyle(content, element.style);
+        }
+        case "user":
+            return applyMarkdownStyle(renderUserMentionAsMarkdown(element.user_id, options), element.style);
+        case "usergroup":
+            return applyMarkdownStyle(renderUserGroupMentionAsMarkdown(element.usergroup_id, options), element.style);
+        case "team":
+            return applyMarkdownStyle(renderTeamMentionAsMarkdown(element.team_id, options), element.style);
+        case "channel":
+            return applyMarkdownStyle(renderChannelMentionAsMarkdown(element.channel_id, options), element.style);
+        case "broadcast":
+            return applyMarkdownStyle(`<!${element.range}>`, element.style);
+        case "color":
+            return applyMarkdownStyle(element.value, element.style);
+        default:
+            return "";
+    }
+}
+function renderImageBlockAsMarkdown(block) {
+    const title = block.title?.text
+        ? ` "${block.title.text.replace(/"/g, '\\"')}"`
+        : "";
+    return `![${block.alt_text}](<${block.image_url}>${title})`;
+}
+function renderImageElementAsMarkdown(element) {
+    return `![${element.alt_text}](<${element.image_url}>)`;
+}
+function renderTableBlockAsMarkdown(block, options) {
+    if (block.rows.length === 0 || block.rows[0].length === 0) {
+        return "";
+    }
+    const rows = block.rows.map((row) => `| ${row.map((cell) => renderTableCellAsMarkdown(cell, options)).join(" | ")} |`);
+    const separator = `| ${block.rows[0].map(() => "---").join(" | ")} |`;
+    return [rows[0], separator, ...rows.slice(1)].join("\n");
+}
+function renderTableCellAsMarkdown(cell, options) {
+    return renderRichTextBlockAsMarkdown(cell, options)
+        .replace(/\|/g, "\\|")
+        .replace(/\n/g, "\\n");
+}
+function applyMarkdownStyle(text, style) {
+    if (!style)
+        return text;
+    let result = text;
+    if (style.code) {
+        result = wrapInlineCode(result);
+    }
+    if (style.bold) {
+        result = `**${result}**`;
+    }
+    if (style.italic) {
+        result = `*${result}*`;
+    }
+    if (style.strike) {
+        result = `~${result}~`;
+    }
+    return result;
+}
+function wrapInlineCode(text) {
+    const fence = getBacktickFence(text, 1);
+    return `${fence}${text}${fence}`;
+}
+function wrapFencedCodeBlock(text) {
+    const fence = getBacktickFence(text, 3);
+    return `${fence}\n${text}\n${fence}`;
+}
+function getBacktickFence(text, minimumLength) {
+    const runs = text.match(/`+/g);
+    const longestRun = runs?.reduce((max, run) => Math.max(max, run.length), 0) ?? 0;
+    return "`".repeat(Math.max(minimumLength, longestRun + 1));
+}
+function indentMultilineMarkdown(prefix, text) {
+    const lines = text.split("\n");
+    if (lines.length === 0)
+        return prefix.trimEnd();
+    const continuation = " ".repeat(prefix.length);
+    return lines
+        .map((line, index) => index === 0 ? `${prefix}${line}` : `${continuation}${line}`)
+        .join("\n");
+}
+function convertMrkdwnToMarkdown(text, options) {
+    let result = "";
+    for (let index = 0; index < text.length; index++) {
+        const character = text[index];
+        if (character === "`") {
+            const closingIndex = text.indexOf("`", index + 1);
+            if (closingIndex !== -1) {
+                result += wrapInlineCode(text.slice(index + 1, closingIndex));
+                index = closingIndex;
+                continue;
+            }
+        }
+        if (character === "<") {
+            const closingIndex = text.indexOf(">", index + 1);
+            if (closingIndex !== -1) {
+                result += convertAngleBracketTokenToMarkdown(text.slice(index, closingIndex + 1), options);
+                index = closingIndex;
+                continue;
+            }
+        }
+        if (isMrkdwnStyleMarker(character) && isValidMrkdwnStyleOpen(text, index)) {
+            const closingIndex = findClosingMrkdwnStyleMarker(text, index);
+            if (closingIndex !== -1) {
+                const inner = convertMrkdwnToMarkdown(text.slice(index + 1, closingIndex), options);
+                result += wrapConvertedMrkdwnStyle(character, inner);
+                index = closingIndex;
+                continue;
+            }
+        }
+        result += character;
+    }
+    return result;
+}
+function convertAngleBracketTokenToMarkdown(token, options) {
+    const userMatch = token.match(/^<@([\w.-]+)>$/);
+    if (userMatch) {
+        return renderUserMentionAsMarkdown(userMatch[1], options);
+    }
+    const channelMatch = token.match(/^<#([\w.-]+)>$/);
+    if (channelMatch) {
+        return renderChannelMentionAsMarkdown(channelMatch[1], options);
+    }
+    const subteamMatch = token.match(/^<!subteam\^([\w.-]+)>$/);
+    if (subteamMatch) {
+        const subteamId = subteamMatch[1];
+        return subteamId.startsWith("S")
+            ? renderUserGroupMentionAsMarkdown(subteamId, options)
+            : renderTeamMentionAsMarkdown(subteamId, options);
+    }
+    if (token.startsWith("<!")) {
+        return token;
+    }
+    const formattedLinkMatch = token.match(/^<([^|>]+)\|(.+)>$/);
+    if (formattedLinkMatch) {
+        const [, url, label] = formattedLinkMatch;
+        return `[${convertMrkdwnToMarkdown(label, options)}](<${url}>)`;
+    }
+    const autoLinkMatch = token.match(/^<([^>]+)>$/);
+    if (autoLinkMatch) {
+        return autoLinkMatch[1];
+    }
+    return token;
+}
+function isMrkdwnStyleMarker(character) {
+    return character === "*" || character === "_" || character === "~";
+}
+function isValidMrkdwnStyleOpen(text, index) {
+    const previous = text[index - 1];
+    const next = text[index + 1];
+    return isMrkdwnBoundary(previous) && !isWhitespace(next);
+}
+function isValidMrkdwnStyleClose(text, index) {
+    const previous = text[index - 1];
+    const next = text[index + 1];
+    return !isWhitespace(previous) && isMrkdwnBoundary(next);
+}
+function findClosingMrkdwnStyleMarker(text, openingIndex) {
+    const marker = text[openingIndex];
+    for (let index = openingIndex + 1; index < text.length; index++) {
+        const character = text[index];
+        if (character === "`") {
+            const closingIndex = text.indexOf("`", index + 1);
+            if (closingIndex === -1)
+                return -1;
+            index = closingIndex;
+            continue;
+        }
+        if (character === "<") {
+            const closingIndex = text.indexOf(">", index + 1);
+            if (closingIndex === -1)
+                return -1;
+            index = closingIndex;
+            continue;
+        }
+        if (character === marker && isValidMrkdwnStyleClose(text, index)) {
+            return index;
+        }
+    }
+    return -1;
+}
+function wrapConvertedMrkdwnStyle(marker, text) {
+    if (marker === "*")
+        return `**${text}**`;
+    if (marker === "_")
+        return `*${text}*`;
+    return `~${text}~`;
+}
+function isMrkdwnBoundary(character) {
+    if (character === undefined)
+        return true;
+    return /[\s.,!?;:()[\]{}"'<>/-]/.test(character);
+}
+function isWhitespace(character) {
+    return character !== undefined && /\s/.test(character);
+}
+function renderUserMentionAsMarkdown(userId, options) {
+    return renderNamedMention(options?.mentions?.users?.[userId] ??
+        options?.mentions?.userGroups?.[userId] ??
+        options?.mentions?.teams?.[userId], `<@${userId}>`);
+}
+function renderChannelMentionAsMarkdown(channelId, options) {
+    return renderNamedMention(options?.mentions?.channels?.[channelId], `<#${channelId}>`, "#");
+}
+function renderUserGroupMentionAsMarkdown(userGroupId, options) {
+    return renderNamedMention(options?.mentions?.userGroups?.[userGroupId], `<!subteam^${userGroupId}>`);
+}
+function renderTeamMentionAsMarkdown(teamId, options) {
+    return renderNamedMention(options?.mentions?.teams?.[teamId], `<!subteam^${teamId}>`);
+}
+function renderNamedMention(name, fallback, prefix = "@") {
+    return name ? `${prefix}${name}` : fallback;
+}
+function isImageElement(element) {
+    if (!element || typeof element !== "object")
+        return false;
+    const accessory = element;
+    return (accessory.type === "image" &&
+        typeof accessory.image_url === "string" &&
+        typeof accessory.alt_text === "string");
+}
 /**
  * Generates a lightweight plain-text fallback from a block batch.
  */

package/dist/types.d.ts

@@ -156,4 +156,12 @@ export interface MarkdownToBlocksOptions {
     detectColors?: boolean;
     preferSectionBlocks?: boolean;
 }
+export interface BlocksToMarkdownOptions {
+    mentions?: {
+        users?: Record<string, string>;
+        channels?: Record<string, string>;
+        userGroups?: Record<string, string>;
+        teams?: Record<string, string>;
+    };
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validator.d.ts

@@ -1,3 +1,4 @@
-import type { MarkdownToBlocksOptions } from "./types";
+import type { BlocksToMarkdownOptions, MarkdownToBlocksOptions } from "./types";
 export declare function validateOptions(options?: MarkdownToBlocksOptions): void;
+export declare function validateBlocksToMarkdownOptions(options?: BlocksToMarkdownOptions): void;
 //# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CA8CvE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEhF,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CA8CvE;AAED,wBAAgB,+BAA+B,CAC9C,OAAO,CAAC,EAAE,uBAAuB,GAC/B,IAAI,CA0CN"}

package/dist/validator.js

@@ -1,37 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateOptions = validateOptions;
+exports.validateBlocksToMarkdownOptions = validateBlocksToMarkdownOptions;
 function validateOptions(options) {
     if (!options?.mentions) {
         return;
     }
     const { users, channels, userGroups, teams } = options.mentions;
     if (users) {
-        for (const [name, id] of Object.entries(users)) {
-            if (!/^[UW][A-Z0-9]+$/.test(id)) {
-                throw new Error(`Invalid User ID for '${name}': '${id}'. Must start with U or W and contain only alphanumeric characters.`);
-            }
-        }
+        validateIdValues(users, /^[UW][A-Z0-9]+$/, "User", (name, id) => `Invalid User ID for '${name}': '${id}'. Must start with U or W and contain only alphanumeric characters.`);
     }
     if (channels) {
-        for (const [name, id] of Object.entries(channels)) {
-            if (!/^C[A-Z0-9]+$/.test(id)) {
-                throw new Error(`Invalid Channel ID for '${name}': '${id}'. Must start with C and contain only alphanumeric characters.`);
-            }
-        }
+        validateIdValues(channels, /^C[A-Z0-9]+$/, "Channel", (name, id) => `Invalid Channel ID for '${name}': '${id}'. Must start with C and contain only alphanumeric characters.`);
     }
     if (userGroups) {
-        for (const [name, id] of Object.entries(userGroups)) {
-            if (!/^S[A-Z0-9]+$/.test(id)) {
-                throw new Error(`Invalid User Group ID for '${name}': '${id}'. Must start with S and contain only alphanumeric characters.`);
-            }
-        }
+        validateIdValues(userGroups, /^S[A-Z0-9]+$/, "User Group", (name, id) => `Invalid User Group ID for '${name}': '${id}'. Must start with S and contain only alphanumeric characters.`);
     }
     if (teams) {
-        for (const [name, id] of Object.entries(teams)) {
-            if (!/^T[A-Z0-9]+$/.test(id)) {
-                throw new Error(`Invalid Team ID for '${name}': '${id}'. Must start with T and contain only alphanumeric characters.`);
-            }
+        validateIdValues(teams, /^T[A-Z0-9]+$/, "Team", (name, id) => `Invalid Team ID for '${name}': '${id}'. Must start with T and contain only alphanumeric characters.`);
+    }
+}
+function validateBlocksToMarkdownOptions(options) {
+    if (!options?.mentions) {
+        return;
+    }
+    const { users, channels, userGroups, teams } = options.mentions;
+    if (users) {
+        validateIdKeys(users, /^[UW][A-Z0-9]+$/, (id) => `Invalid User ID key '${id}'. Must start with U or W and contain only alphanumeric characters.`);
+    }
+    if (channels) {
+        validateIdKeys(channels, /^C[A-Z0-9]+$/, (id) => `Invalid Channel ID key '${id}'. Must start with C and contain only alphanumeric characters.`);
+    }
+    if (userGroups) {
+        validateIdKeys(userGroups, /^S[A-Z0-9]+$/, (id) => `Invalid User Group ID key '${id}'. Must start with S and contain only alphanumeric characters.`);
+    }
+    if (teams) {
+        validateIdKeys(teams, /^T[A-Z0-9]+$/, (id) => `Invalid Team ID key '${id}'. Must start with T and contain only alphanumeric characters.`);
+    }
+}
+function validateIdValues(entries, pattern, _kind, buildMessage) {
+    for (const [name, id] of Object.entries(entries)) {
+        if (!pattern.test(id)) {
+            throw new Error(buildMessage(name, id));
+        }
+    }
+}
+function validateIdKeys(entries, pattern, buildMessage) {
+    for (const id of Object.keys(entries)) {
+        if (!pattern.test(id)) {
+            throw new Error(buildMessage(id));
         }
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "markdown-to-slack-blocks",
-	"version": "1.4.0",
-	"description": "Convert Markdown to Slack Block Kit JSON format",
+	"version": "1.5.0",
+	"description": "Convert Markdown to Slack Block Kit JSON format and vice versa.",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
 	"exports": {
@@ -48,7 +48,7 @@
 		"node": ">=18.0.0"
 	},
 	"dependencies": {
-		"mdast-util-from-markdown": "2.0.2",
+		"mdast-util-from-markdown": "2.0.3",
 		"mdast-util-gfm": "3.1.0",
 		"mdast-util-to-string": "4.0.0",
 		"micromark-extension-gfm": "3.0.0"
@@ -58,6 +58,6 @@
 		"@types/node": "24.10.1",
 		"eslint": "9.39.1",
 		"typescript": "5.9.3",
-		"vitest": "4.0.15"
+		"vitest": "4.1.2"
 	}
-}
+}