@repo-toolkit/confluence 0.8.0 → 0.9.0

package/cli.js

@@ -319,9 +319,31 @@ var LT = "<";
 var GT = ">";
 var QUOT = """;
 var APOS = "'";
-function markdownToStorage(markdown) {
-  const lines = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+var MERMAID_PLACEHOLDER_PREFIX = '<ac:structured-macro ac:name="mermaid-placeholder" data-mermaid-id="';
+var MERMAID_PLACEHOLDER_RE_STRICT = /<ac:structured-macro ac:name="mermaid-placeholder" data-mermaid-id="([^"]+)"><\/ac:structured-macro>/g;
+function mermaidPlaceholderRe() {
+  return new RegExp(MERMAID_PLACEHOLDER_RE_STRICT.source, "g");
+}
+function renderMermaidPlaceholder(id) {
+  return `${MERMAID_PLACEHOLDER_PREFIX}${escapeXmlAttribute(id)}"></ac:structured-macro>`;
+}
+function markdownToStorage(markdown, options = {}) {
+  const renderHtmlBlocks = options.renderHtmlBlocks === true;
+  let lines = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  if (lines.length > 0 && lines[0] === "---") {
+    let closeIndex = -1;
+    for (let j = 1; j < lines.length; j += 1) {
+      if (lines[j] === "---" || lines[j] === "...") {
+        closeIndex = j;
+        break;
+      }
+    }
+    if (closeIndex !== -1) {
+      lines = lines.slice(closeIndex + 1);
+    }
+  }
   const out = [];
+  const mermaidBlocks = [];
   let i = 0;
   while (i < lines.length) {
     const line = lines[i];
@@ -344,7 +366,16 @@ function markdownToStorage(markdown) {
         i += 1;
       }
       i += 1;
-      out.push(renderCodeBlock(buf.join("\n"), lang));
+      const code = buf.join("\n");
+      if (lang === "mermaid") {
+        const id = `mermaid-${mermaidBlocks.length + 1}`;
+        mermaidBlocks.push({ id, source: code });
+        out.push(renderMermaidPlaceholder(id));
+      } else if (lang === "html" && renderHtmlBlocks) {
+        out.push(renderHtmlBlock(code));
+      } else {
+        out.push(renderCodeBlock(code, lang));
+      }
       continue;
     }
     if (/^\s{0,3}(?:-|\*|\+)\s+/.test(line) || /^\s{0,3}\d+\.\s+/.test(line)) {
@@ -381,7 +412,7 @@ function markdownToStorage(markdown) {
     const renderedPara = renderInline(para.join(LINE_BREAK_SENTINEL));
     out.push(`<p>${renderedPara.split(LINE_BREAK_SENTINEL).join(STORAGE_LINE_BREAK)}</p>`);
   }
-  return { html: out.join("\n") };
+  return { html: out.join("\n"), mermaidBlocks };
 }
 function isLikelyListTerminator(lines, currentIndex) {
   for (let k = currentIndex + 1; k < lines.length; k += 1) {
@@ -408,6 +439,9 @@ function renderCodeBlock(code, _lang) {
   const titleAttr = escapeXmlAttribute(lang);
   return `<ac:structured-macro ac:name="code"><ac:parameter ac:name="language">${titleAttr}</ac:parameter><ac:plain-text-body><![CDATA[${escapeCdataTerminator(code)}]]></ac:plain-text-body></ac:structured-macro>`;
 }
+function renderHtmlBlock(code) {
+  return `<ac:structured-macro ac:name="html"><ac:plain-text-body><![CDATA[${escapeCdataTerminator(code)}]]></ac:plain-text-body></ac:structured-macro>`;
+}
 function escapeCdataTerminator(text) {
   return text.replace(/]]>/g, "]]]]><![CDATA[>");
 }
@@ -614,6 +648,115 @@ function decodePlaceholder(value) {
   return value.replace(new RegExp(AMP2, "g"), "&").replace(new RegExp(QUOT2, "g"), '"').replace(new RegExp(LT2, "g"), "<").replace(new RegExp(GT2, "g"), ">");
 }
 
+// src/mermaid.ts
+import { spawn, spawnSync } from "child_process";
+import { mkdtemp, rm, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join2 } from "path";
+async function rewriteMermaidBlocks(html, blocks, pageId, client, options = {}) {
+  const fallbacks = [];
+  const uploaded = [];
+  if (blocks.length === 0) {
+    return { html, fallbacks, uploaded };
+  }
+  const existing = await client.getAttachments(pageId);
+  const existingByName = /* @__PURE__ */ new Map();
+  for (const a of existing) {
+    const name = a.filename ?? a.title;
+    if (name) {
+      existingByName.set(name, a);
+    }
+  }
+  const renderHook = options.renderHook ?? defaultRenderHook;
+  let mmdcAvailable;
+  if (options.renderHook) {
+    mmdcAvailable = true;
+  } else if (options.available !== void 0) {
+    mmdcAvailable = options.available;
+  } else {
+    mmdcAvailable = await isMmdcAvailable(options.mmdcPath);
+  }
+  const placeholderToAttachment = /* @__PURE__ */ new Map();
+  for (const block of blocks) {
+    if (!mmdcAvailable) {
+      fallbacks.push(block.id);
+      continue;
+    }
+    const workDir = await mkdtemp(join2(tmpdir(), "rt-mermaid-"));
+    try {
+      const inPath = join2(workDir, "diagram.mmd");
+      const outPath = join2(workDir, "diagram.svg");
+      await writeFile(inPath, block.source, "utf8");
+      await renderHook(block.source, outPath);
+      const filename = escapeAttachmentFilename(`${block.id}.svg`);
+      let attachment = existingByName.get(filename);
+      if (attachment && attachment.id) {
+        attachment = await client.updateAttachmentData(
+          pageId,
+          attachment.id,
+          outPath,
+          `Updated via repo-toolkit-confluence`
+        );
+      } else {
+        attachment = await client.uploadAttachment(pageId, outPath, `Uploaded via repo-toolkit-confluence`);
+      }
+      uploaded.push({ id: block.id, attachment });
+      placeholderToAttachment.set(block.id, filename);
+    } catch {
+      fallbacks.push(block.id);
+    } finally {
+      await rm(workDir, { recursive: true, force: true }).catch(() => {
+      });
+    }
+  }
+  const remainingIds = new Set(fallbacks);
+  const re = mermaidPlaceholderRe();
+  const replaced = html.replace(re, (full, id) => {
+    const filename = placeholderToAttachment.get(id);
+    if (filename) {
+      return renderAttachmentMacro2(filename);
+    }
+    if (remainingIds.has(id)) {
+      const block = blocks.find((b) => b.id === id);
+      if (block) {
+        return renderCodeBlock(block.source, "mermaid");
+      }
+    }
+    return full;
+  });
+  return { html: replaced, fallbacks, uploaded };
+}
+function renderAttachmentMacro2(filename) {
+  const safe = escapeAttachmentFilename(filename);
+  return `<ac:image><ri:attachment ri:filename="${escapeXmlAttribute(safe)}" /></ac:image>`;
+}
+async function isMmdcAvailable(override) {
+  if (override) {
+    return true;
+  }
+  return spawnSync("sh", ["-c", "command -v mmdc"], { stdio: "ignore" }).status === 0;
+}
+async function defaultRenderHook(source, outFile) {
+  return new Promise((resolve3, reject) => {
+    const child = spawn("mmdc", ["-i", "-", "-o", outFile, "-t", "default", "-b", "transparent"], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (err) => reject(err));
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve3();
+      } else {
+        reject(new Error(`mmdc exited with code ${code}${stderr ? `: ${stderr}` : ""}`));
+      }
+    });
+    child.stdin?.end(source);
+  });
+}
+
 // src/index.ts
 function resolveConfluenceSyncPlan(options = {}) {
   const cwd = resolve2(options.cwd ?? process.cwd());
@@ -651,7 +794,8 @@ function resolveConfluenceSyncPlan(options = {}) {
     parentPageId: options.parentPageId ?? "",
     versionMessage: options.versionMessage ?? "Synced via repo-toolkit-confluence",
     skipUnchanged: options.skipUnchanged ?? true,
-    dryRun: options.dryRun ?? false
+    dryRun: options.dryRun ?? false,
+    renderHtmlBlocks: options.renderHtmlBlocks === true
   };
 }
 async function syncConfluenceToDocs(options = {}) {
@@ -696,9 +840,20 @@ async function syncEntry(entry, plan, client, cache, log) {
       const page2 = await cache.findOrCreate(title, currentParentId);
       const pageId = page2.id;
       const markdown = readFileSync2(entry.absolute, "utf8");
-      const { html } = markdownToStorage(markdown);
+      const { html, mermaidBlocks } = markdownToStorage(markdown, {
+        renderHtmlBlocks: plan.renderHtmlBlocks
+      });
       const markdownDir = dirname(entry.absolute);
       let body = html;
+      if (mermaidBlocks.length > 0) {
+        const mermaidResult = await rewriteMermaidBlocks(body, mermaidBlocks, pageId, client);
+        body = mermaidResult.html;
+        if (mermaidResult.fallbacks.length > 0) {
+          log(
+            `mermaid: ${mermaidResult.fallbacks.length} block(s) not rendered (mmdc unavailable or failed); emitted as code macros`
+          );
+        }
+      }
       LOCAL_IMAGE_PLACEHOLDER_RE.lastIndex = 0;
       if (LOCAL_IMAGE_PLACEHOLDER_RE.test(body)) {
         const result = await rewriteImagesToAttachments(body, pageId, client, { markdownDir });
@@ -776,6 +931,7 @@ var SPECS = [
   { name: "version-message" },
   { name: "skip-unchanged", boolean: true, negatable: true },
   { name: "dry-run", boolean: true },
+  { name: "render-html-blocks", boolean: true },
   INTERACTIVE_FLAG
 ];
 function printHelp() {
@@ -802,6 +958,8 @@ Options:
   --skip-unchanged               Skip pages whose body is unchanged (default: true)
   --no-skip-unchanged           Re-upload every page even when unchanged
   --dry-run                     Walk the doc tree and print the plan without API calls
+  --render-html-blocks          Render \`\`\`html fenced blocks as inline HTML via the
+                                Confluence html macro (default: false; emits as code box)
   -i, --interactive             (reserved; not currently interactive)
   -h, --help                    Show this help message
 `);
@@ -814,7 +972,8 @@ var ENV_INPUT_MAP = [
   ["INPUT_CONFLUENCE-BASE-URL", "baseUrl"],
   ["INPUT_SPACE-KEY", "spaceKey"],
   ["INPUT_PARENT-PAGE-ID", "parentPageId"],
-  ["INPUT_VERSION-MESSAGE", "versionMessage"]
+  ["INPUT_VERSION-MESSAGE", "versionMessage"],
+  ["INPUT_RENDER-HTML-BLOCKS", "renderHtmlBlocks"]
 ];
 function buildOptions(result) {
   if (!result) {
@@ -835,6 +994,7 @@ function buildOptions(result) {
   if (values["version-message"]) options.versionMessage = values["version-message"];
   if (values["skip-unchanged"] !== void 0) options.skipUnchanged = values["skip-unchanged"] === "true";
   if (values["dry-run"] !== void 0) options.dryRun = true;
+  if (values["render-html-blocks"] !== void 0) options.renderHtmlBlocks = true;
   return options;
 }
 function optionsFromEnv() {
@@ -842,7 +1002,11 @@ function optionsFromEnv() {
   for (const [envName, key] of ENV_INPUT_MAP) {
     const value = process.env[envName];
     if (typeof value === "string" && value.length > 0) {
-      options[key] = value;
+      if (key === "renderHtmlBlocks") {
+        options[key] = value === "true" || value === "1";
+      } else {
+        options[key] = value;
+      }
     }
   }
   return options;

package/index.d.ts

@@ -111,10 +111,20 @@ declare function readDocTree(root: string, depth?: number): Promise<DocTree>;
 declare function isMarkdownName(name: string): boolean;
 declare function titleFromSegment(segment: string): string;
 
+interface MermaidBlock {
+    id: string;
+    source: string;
+}
 interface MarkdownConvertResult {
     html: string;
+    mermaidBlocks: MermaidBlock[];
+}
+interface MarkdownConvertOptions {
+    /** Render ```html fenced blocks as inline HTML via the Confluence `html` macro instead of a code box. Default: false. */
+    renderHtmlBlocks?: boolean;
 }
-declare function markdownToStorage(markdown: string): MarkdownConvertResult;
+declare function markdownToStorage(markdown: string, options?: MarkdownConvertOptions): MarkdownConvertResult;
+declare function renderHtmlBlock(code: string): string;
 declare function renderInline(text: string): string;
 declare const LOCAL_IMAGE_PLACEHOLDER_RE: RegExp;
 declare function isRemoteUrl(src: string): boolean;
@@ -134,6 +144,25 @@ interface RewriteOptions {
 }
 declare function rewriteImagesToAttachments(html: string, pageId: string, client: ConfluenceClient, options: RewriteOptions): Promise<RewriteResult>;
 
+interface MermaidRewriteResult {
+    html: string;
+    /** Placeholders that could not be rendered (mmdc missing or render failure). Fallback source is in the original code macro. */
+    fallbacks: string[];
+    uploaded: ReadonlyArray<{
+        id: string;
+        attachment: Attachment;
+    }>;
+}
+interface MermaidRewriteOptions {
+    /** Override the mmdc binary path; otherwise discovered via PATH. */
+    mmdcPath?: string;
+    /** Override the render command for tests (must write a valid SVG at outFile). */
+    renderHook?: (source: string, outFile: string) => Promise<void>;
+    /** Force-enable or force-disable rendering regardless of PATH detection. When true, skips the mmdc probe. */
+    available?: boolean;
+}
+declare function rewriteMermaidBlocks(html: string, blocks: MermaidBlock[], pageId: string, client: ConfluenceClient, options?: MermaidRewriteOptions): Promise<MermaidRewriteResult>;
+
 declare const INTERACTIVE_FLAG: FlagSpec;
 interface ConfluenceSyncOptions {
     /** Documentation root folder (relative to `cwd`, or absolute). Required. */
@@ -154,6 +183,8 @@ interface ConfluenceSyncOptions {
     versionMessage?: string;
     /** Skip uploads that would have no markdown changes (default: true). */
     skipUnchanged?: boolean;
+    /** Render ```html fenced blocks as inline HTML via the Confluence `html` macro instead of a code box (default: false). */
+    renderHtmlBlocks?: boolean;
     /** Dry-run: walk the tree and print the plan but make no API calls. */
     dryRun?: boolean;
     /** Custom Confluence client instance (testing). When supplied, `username`/`apiToken`/`baseUrl` are ignored. */
@@ -172,8 +203,9 @@ interface ConfluenceSyncPlan {
     versionMessage: string;
     skipUnchanged: boolean;
     dryRun: boolean;
+    renderHtmlBlocks: boolean;
 }
 declare function resolveConfluenceSyncPlan(options?: ConfluenceSyncOptions): ConfluenceSyncPlan;
 declare function syncConfluenceToDocs(options?: ConfluenceSyncOptions): Promise<void>;
 
-export { type Attachment, ConfluenceApiError, ConfluenceClient, type ConfluenceClientOptions, type ConfluenceSyncOptions, type ConfluenceSyncPlan, type DocEntry, type DocTree, INTERACTIVE_FLAG, LOCAL_IMAGE_PLACEHOLDER_RE, type Page, type PageBody, type PageVersion, escapeAttachmentFilename, escapeXmlAttribute, isMarkdownName, isRemoteUrl, markdownToStorage, readDocTree, renderInline, resolveConfluenceSyncPlan, resolveConfluenceSyncPlan as resolveSyncPlan, rewriteImagesToAttachments, syncConfluenceToDocs, titleFromSegment };
+export { type Attachment, ConfluenceApiError, ConfluenceClient, type ConfluenceClientOptions, type ConfluenceSyncOptions, type ConfluenceSyncPlan, type DocEntry, type DocTree, INTERACTIVE_FLAG, LOCAL_IMAGE_PLACEHOLDER_RE, type MarkdownConvertOptions, type MarkdownConvertResult, type MermaidBlock, type MermaidRewriteOptions, type MermaidRewriteResult, type Page, type PageBody, type PageVersion, escapeAttachmentFilename, escapeXmlAttribute, isMarkdownName, isRemoteUrl, markdownToStorage, readDocTree, renderHtmlBlock, renderInline, resolveConfluenceSyncPlan, resolveConfluenceSyncPlan as resolveSyncPlan, rewriteImagesToAttachments, rewriteMermaidBlocks, syncConfluenceToDocs, titleFromSegment };

package/index.js

@@ -314,9 +314,31 @@ var LT = "<";
 var GT = ">";
 var QUOT = """;
 var APOS = "'";
-function markdownToStorage(markdown) {
-  const lines = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+var MERMAID_PLACEHOLDER_PREFIX = '<ac:structured-macro ac:name="mermaid-placeholder" data-mermaid-id="';
+var MERMAID_PLACEHOLDER_RE_STRICT = /<ac:structured-macro ac:name="mermaid-placeholder" data-mermaid-id="([^"]+)"><\/ac:structured-macro>/g;
+function mermaidPlaceholderRe() {
+  return new RegExp(MERMAID_PLACEHOLDER_RE_STRICT.source, "g");
+}
+function renderMermaidPlaceholder(id) {
+  return `${MERMAID_PLACEHOLDER_PREFIX}${escapeXmlAttribute(id)}"></ac:structured-macro>`;
+}
+function markdownToStorage(markdown, options = {}) {
+  const renderHtmlBlocks = options.renderHtmlBlocks === true;
+  let lines = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  if (lines.length > 0 && lines[0] === "---") {
+    let closeIndex = -1;
+    for (let j = 1; j < lines.length; j += 1) {
+      if (lines[j] === "---" || lines[j] === "...") {
+        closeIndex = j;
+        break;
+      }
+    }
+    if (closeIndex !== -1) {
+      lines = lines.slice(closeIndex + 1);
+    }
+  }
   const out = [];
+  const mermaidBlocks = [];
   let i = 0;
   while (i < lines.length) {
     const line = lines[i];
@@ -339,7 +361,16 @@ function markdownToStorage(markdown) {
         i += 1;
       }
       i += 1;
-      out.push(renderCodeBlock(buf.join("\n"), lang));
+      const code = buf.join("\n");
+      if (lang === "mermaid") {
+        const id = `mermaid-${mermaidBlocks.length + 1}`;
+        mermaidBlocks.push({ id, source: code });
+        out.push(renderMermaidPlaceholder(id));
+      } else if (lang === "html" && renderHtmlBlocks) {
+        out.push(renderHtmlBlock(code));
+      } else {
+        out.push(renderCodeBlock(code, lang));
+      }
       continue;
     }
     if (/^\s{0,3}(?:-|\*|\+)\s+/.test(line) || /^\s{0,3}\d+\.\s+/.test(line)) {
@@ -376,7 +407,7 @@ function markdownToStorage(markdown) {
     const renderedPara = renderInline(para.join(LINE_BREAK_SENTINEL));
     out.push(`<p>${renderedPara.split(LINE_BREAK_SENTINEL).join(STORAGE_LINE_BREAK)}</p>`);
   }
-  return { html: out.join("\n") };
+  return { html: out.join("\n"), mermaidBlocks };
 }
 function isLikelyListTerminator(lines, currentIndex) {
   for (let k = currentIndex + 1; k < lines.length; k += 1) {
@@ -403,6 +434,9 @@ function renderCodeBlock(code, _lang) {
   const titleAttr = escapeXmlAttribute(lang);
   return `<ac:structured-macro ac:name="code"><ac:parameter ac:name="language">${titleAttr}</ac:parameter><ac:plain-text-body><![CDATA[${escapeCdataTerminator(code)}]]></ac:plain-text-body></ac:structured-macro>`;
 }
+function renderHtmlBlock(code) {
+  return `<ac:structured-macro ac:name="html"><ac:plain-text-body><![CDATA[${escapeCdataTerminator(code)}]]></ac:plain-text-body></ac:structured-macro>`;
+}
 function escapeCdataTerminator(text) {
   return text.replace(/]]>/g, "]]]]><![CDATA[>");
 }
@@ -609,6 +643,115 @@ function decodePlaceholder(value) {
   return value.replace(new RegExp(AMP2, "g"), "&").replace(new RegExp(QUOT2, "g"), '"').replace(new RegExp(LT2, "g"), "<").replace(new RegExp(GT2, "g"), ">");
 }
 
+// src/mermaid.ts
+import { spawn, spawnSync } from "child_process";
+import { mkdtemp, rm, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join2 } from "path";
+async function rewriteMermaidBlocks(html, blocks, pageId, client, options = {}) {
+  const fallbacks = [];
+  const uploaded = [];
+  if (blocks.length === 0) {
+    return { html, fallbacks, uploaded };
+  }
+  const existing = await client.getAttachments(pageId);
+  const existingByName = /* @__PURE__ */ new Map();
+  for (const a of existing) {
+    const name = a.filename ?? a.title;
+    if (name) {
+      existingByName.set(name, a);
+    }
+  }
+  const renderHook = options.renderHook ?? defaultRenderHook;
+  let mmdcAvailable;
+  if (options.renderHook) {
+    mmdcAvailable = true;
+  } else if (options.available !== void 0) {
+    mmdcAvailable = options.available;
+  } else {
+    mmdcAvailable = await isMmdcAvailable(options.mmdcPath);
+  }
+  const placeholderToAttachment = /* @__PURE__ */ new Map();
+  for (const block of blocks) {
+    if (!mmdcAvailable) {
+      fallbacks.push(block.id);
+      continue;
+    }
+    const workDir = await mkdtemp(join2(tmpdir(), "rt-mermaid-"));
+    try {
+      const inPath = join2(workDir, "diagram.mmd");
+      const outPath = join2(workDir, "diagram.svg");
+      await writeFile(inPath, block.source, "utf8");
+      await renderHook(block.source, outPath);
+      const filename = escapeAttachmentFilename(`${block.id}.svg`);
+      let attachment = existingByName.get(filename);
+      if (attachment && attachment.id) {
+        attachment = await client.updateAttachmentData(
+          pageId,
+          attachment.id,
+          outPath,
+          `Updated via repo-toolkit-confluence`
+        );
+      } else {
+        attachment = await client.uploadAttachment(pageId, outPath, `Uploaded via repo-toolkit-confluence`);
+      }
+      uploaded.push({ id: block.id, attachment });
+      placeholderToAttachment.set(block.id, filename);
+    } catch {
+      fallbacks.push(block.id);
+    } finally {
+      await rm(workDir, { recursive: true, force: true }).catch(() => {
+      });
+    }
+  }
+  const remainingIds = new Set(fallbacks);
+  const re = mermaidPlaceholderRe();
+  const replaced = html.replace(re, (full, id) => {
+    const filename = placeholderToAttachment.get(id);
+    if (filename) {
+      return renderAttachmentMacro2(filename);
+    }
+    if (remainingIds.has(id)) {
+      const block = blocks.find((b) => b.id === id);
+      if (block) {
+        return renderCodeBlock(block.source, "mermaid");
+      }
+    }
+    return full;
+  });
+  return { html: replaced, fallbacks, uploaded };
+}
+function renderAttachmentMacro2(filename) {
+  const safe = escapeAttachmentFilename(filename);
+  return `<ac:image><ri:attachment ri:filename="${escapeXmlAttribute(safe)}" /></ac:image>`;
+}
+async function isMmdcAvailable(override) {
+  if (override) {
+    return true;
+  }
+  return spawnSync("sh", ["-c", "command -v mmdc"], { stdio: "ignore" }).status === 0;
+}
+async function defaultRenderHook(source, outFile) {
+  return new Promise((resolve3, reject) => {
+    const child = spawn("mmdc", ["-i", "-", "-o", outFile, "-t", "default", "-b", "transparent"], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (err) => reject(err));
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve3();
+      } else {
+        reject(new Error(`mmdc exited with code ${code}${stderr ? `: ${stderr}` : ""}`));
+      }
+    });
+    child.stdin?.end(source);
+  });
+}
+
 // src/index.ts
 var INTERACTIVE_FLAG = { name: "interactive", aliases: ["i"], boolean: true };
 function resolveConfluenceSyncPlan(options = {}) {
@@ -647,7 +790,8 @@ function resolveConfluenceSyncPlan(options = {}) {
     parentPageId: options.parentPageId ?? "",
     versionMessage: options.versionMessage ?? "Synced via repo-toolkit-confluence",
     skipUnchanged: options.skipUnchanged ?? true,
-    dryRun: options.dryRun ?? false
+    dryRun: options.dryRun ?? false,
+    renderHtmlBlocks: options.renderHtmlBlocks === true
   };
 }
 async function syncConfluenceToDocs(options = {}) {
@@ -692,9 +836,20 @@ async function syncEntry(entry, plan, client, cache, log) {
       const page2 = await cache.findOrCreate(title, currentParentId);
       const pageId = page2.id;
       const markdown = readFileSync2(entry.absolute, "utf8");
-      const { html } = markdownToStorage(markdown);
+      const { html, mermaidBlocks } = markdownToStorage(markdown, {
+        renderHtmlBlocks: plan.renderHtmlBlocks
+      });
       const markdownDir = dirname(entry.absolute);
       let body = html;
+      if (mermaidBlocks.length > 0) {
+        const mermaidResult = await rewriteMermaidBlocks(body, mermaidBlocks, pageId, client);
+        body = mermaidResult.html;
+        if (mermaidResult.fallbacks.length > 0) {
+          log(
+            `mermaid: ${mermaidResult.fallbacks.length} block(s) not rendered (mmdc unavailable or failed); emitted as code macros`
+          );
+        }
+      }
       LOCAL_IMAGE_PLACEHOLDER_RE.lastIndex = 0;
       if (LOCAL_IMAGE_PLACEHOLDER_RE.test(body)) {
         const result = await rewriteImagesToAttachments(body, pageId, client, { markdownDir });
@@ -771,11 +926,13 @@ export {
   markdownToStorage,
   parseFlags,
   readDocTree,
+  renderHtmlBlock,
   renderInline,
   resolveCliOptions,
   resolveConfluenceSyncPlan,
   resolveConfluenceSyncPlan as resolveSyncPlan,
   rewriteImagesToAttachments,
+  rewriteMermaidBlocks,
   syncConfluenceToDocs,
   titleFromSegment
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@repo-toolkit/confluence",
   "description": "Sync a folder of markdown docs to Confluence pages and attachments (GitHub Action compatible)",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "sideEffects": false,
   "keywords": [
@@ -27,7 +27,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@repo-toolkit/publish-package": "0.8.0"
+    "@repo-toolkit/publish-package": "0.9.0"
   },
   "files": [
     "**/*",