nizel-kit 0.1.8 → 0.1.10

package/dist/nizel-kit.iife.js

@@ -64,8 +64,36 @@ var NizelKit = (() => {
   ]);
   var passthroughInlineTags = /* @__PURE__ */ new Set(["abbr", "bdi", "bdo", "cite", "data", "dfn", "kbd", "mark", "q", "samp", "small", "sub", "sup", "time", "u", "var"]);
   function htmlToMarkdown(html, options = {}) {
+    const resolved = {
+      unsupported: options.unsupported ?? "preserve",
+      plugins: options.plugins ?? []
+    };
+    const handlers = resolved.plugins.flatMap((plugin) => {
+      const handler = plugin?.htmlToMarkdown;
+      return handler ? Array.isArray(handler) ? handler : [handler] : [];
+    });
+    const ctx = { options: resolved, handlers, epilogue: [] };
     const root = parseHtml(html);
-    return normalizeDocument(renderChildren(root.children, { unsupported: options.unsupported ?? "preserve" }, 0));
+    const body = normalizeDocument(renderChildren(root.children, ctx, 0));
+    return ctx.epilogue.length ? normalizeDocument(`${body}
+
+${ctx.epilogue.join("\n\n")}`) : body;
+  }
+  function buildHandlerContext(node, ctx, depth) {
+    return {
+      options: ctx.options,
+      inline: (target) => normalizeInline(renderChildren(childrenOf(target), ctx, depth)),
+      block: (target) => normalizeDocument(renderChildren(childrenOf(target), ctx, depth)),
+      text: (target) => textContent(target),
+      indent: (value, size) => indentContinuation(value, size),
+      epilogue: (value) => {
+        if (value)
+          ctx.epilogue.push(value);
+      }
+    };
+  }
+  function childrenOf(node) {
+    return node.type === "element" || node.type === "root" ? node.children : [];
   }
   function parseHtml(html) {
     const root = { type: "root", children: [] };
@@ -167,25 +195,31 @@ var NizelKit = (() => {
   function slugifyText(value) {
     return value.toLowerCase().replace(/[^\w\s-]/g, "").replace(/[\s_]+/g, "-").replace(/^-+|-+$/g, "");
   }
-  function renderChildren(nodes, options, depth) {
-    return nodes.map((node) => renderNode(node, options, depth)).join("");
+  function renderChildren(nodes, ctx, depth) {
+    return nodes.map((node) => renderNode(node, ctx, depth)).join("");
   }
-  function renderNode(node, options, depth) {
+  function renderNode(node, ctx, depth) {
     if (node.type === "text")
       return collapseText(decodeEntities(node.value));
     if (node.type === "comment")
-      return options.unsupported === "preserve" ? node.value : " ";
+      return ctx.options.unsupported === "preserve" ? node.value : " ";
     if (node.type === "root")
-      return renderChildren(node.children, options, depth);
-    const inline = () => normalizeInline(renderChildren(node.children, options, depth));
-    const block = () => normalizeDocument(renderChildren(node.children, options, depth));
-    if (options.unsupported === "preserve" && hasUnsupportedAttrs(node)) {
+      return renderChildren(node.children, ctx, depth);
+    const inline = () => normalizeInline(renderChildren(node.children, ctx, depth));
+    const block = () => normalizeDocument(renderChildren(node.children, ctx, depth));
+    for (const handler of ctx.handlers) {
+      const result = handler(node, buildHandlerContext(node, ctx, depth));
+      if (result !== void 0) {
+        return blockTags.has(node.tag) ? blockWrap(result) : result;
+      }
+    }
+    if (ctx.options.unsupported === "preserve" && hasUnsupportedAttrs(node)) {
       return blockTags.has(node.tag) ? blockWrap(node.raw) : node.raw;
     }
     if (/^h[1-6]$/.test(node.tag))
       return blockWrap(`${"#".repeat(Number(node.tag[1]))} ${inline()}`);
     if (node.tag === "p")
-      return blockWrap(normalizeParagraph(renderChildren(node.children, options, depth)));
+      return blockWrap(normalizeParagraph(renderChildren(node.children, ctx, depth)));
     if (node.tag === "br")
       return "  \n";
     if (node.tag === "hr")
@@ -207,13 +241,13 @@ var NizelKit = (() => {
     if (node.tag === "blockquote")
       return blockWrap(prefixLines(block(), "> "));
     if (node.tag === "ul" || node.tag === "ol")
-      return blockWrap(renderList(node, options, depth));
+      return blockWrap(renderList(node, ctx, depth));
     if (node.tag === "li")
       return inline();
     if (node.tag === "table") {
-      if (options.unsupported === "preserve" && tableHasUnsupportedStructure(node))
+      if (ctx.options.unsupported === "preserve" && tableHasUnsupportedStructure(node))
         return blockWrap(node.raw);
-      return blockWrap(renderTable(node, options));
+      return blockWrap(renderTable(node, ctx));
     }
     if (node.tag === "thead" || node.tag === "tbody" || node.tag === "tr" || node.tag === "th" || node.tag === "td")
       return inline();
@@ -222,9 +256,9 @@ var NizelKit = (() => {
     if (node.tag === "span")
       return inline();
     if (passthroughInlineTags.has(node.tag) || blockTags.has(node.tag)) {
-      return options.unsupported === "preserve" ? node.raw : block();
+      return ctx.options.unsupported === "preserve" ? node.raw : block();
     }
-    return options.unsupported === "preserve" ? node.raw : inline();
+    return ctx.options.unsupported === "preserve" ? node.raw : inline();
   }
   function renderLink(node, text) {
     const href = node.attrs.href;
@@ -257,19 +291,19 @@ var NizelKit = (() => {
 ${code}
 ${fence}`;
   }
-  function renderList(node, options, depth) {
+  function renderList(node, ctx, depth) {
     return node.children.filter((child) => child.type === "element" && child.tag === "li").map((item, index) => {
       const marker = node.tag === "ol" ? `${Number(node.attrs.start ?? 1) + index}. ` : "- ";
-      const body = normalizeListItemBody(renderChildren(item.children, options, depth + 1));
+      const body = normalizeListItemBody(renderChildren(item.children, ctx, depth + 1));
       return indentContinuation(`${marker}${body}`, marker.length);
     }).join("\n");
   }
-  function renderTable(node, options) {
+  function renderTable(node, ctx) {
     const rows = collectRows(node).map((row) => row.children.filter((cell) => cell.type === "element" && (cell.tag === "th" || cell.tag === "td"))).filter((row) => row.length > 0);
     if (rows.length === 0)
       return "";
     const width = Math.max(...rows.map((row) => row.length));
-    const values = rows.map((row) => Array.from({ length: width }, (_, index) => normalizeInline(renderChildren(row[index]?.children ?? [], options, 0))));
+    const values = rows.map((row) => Array.from({ length: width }, (_, index) => normalizeInline(renderChildren(row[index]?.children ?? [], ctx, 0))));
     const header = values[0];
     const separator = Array.from({ length: width }, () => "---");
     const body = values.slice(1);
@@ -366,6 +400,20 @@ ${trimmed}
     }
     return longest;
   }
+  var htmlChildElements = (node) => node.type === "element" || node.type === "root" ? node.children.filter((child) => child.type === "element") : [];
+  var findHtmlElement = (node, predicate) => htmlChildElements(node).find(predicate);
+  var hasHtmlClass = (node, className) => node.type === "element" && (node.attrs.class ?? "").split(/\s+/).includes(className);
+  var findHtmlDescendant = (node, predicate) => {
+    for (const child of htmlChildElements(node)) {
+      if (predicate(child))
+        return child;
+      const nested = findHtmlDescendant(child, predicate);
+      if (nested)
+        return nested;
+    }
+    return void 0;
+  };
+  var htmlRoot = (children) => ({ type: "root", children });
 
   // ../nizel/dist/collect.js
   function collect(ast) {
@@ -4877,7 +4925,22 @@ ${body}
         afterParse(ast) {
           return replaceAbbreviations(ast, definitions);
         }
-      }
+      },
+      htmlToMarkdown: abbrToMarkdown()
+    };
+  };
+  var abbrToMarkdown = () => {
+    const seen = /* @__PURE__ */ new Set();
+    return (node, ctx) => {
+      if (node.type !== "element" || node.tag !== "abbr")
+        return void 0;
+      const term = ctx.text(node).trim();
+      const title = node.attrs.title;
+      if (title !== void 0 && term && !seen.has(term)) {
+        seen.add(term);
+        ctx.epilogue(`*[${term}]: ${title}`);
+      }
+      return term;
     };
   };
   var extractAbbreviations = (markdown) => {
@@ -4945,7 +5008,25 @@ ${body}
       blocks,
       hooks: {
         beforeParse: transformGitHubAlerts
-      }
+      },
+      htmlToMarkdown: alertToMarkdown(options)
+    };
+  };
+  var alertToMarkdown = (options = {}) => {
+    const rootClass = options.className ?? "alert";
+    return (node, ctx) => {
+      if (node.type !== "element" || node.tag !== "div")
+        return void 0;
+      const type = node.attrs["data-alert"];
+      if (!type)
+        return void 0;
+      const titleEl = findHtmlElement(node, (el) => el.tag === "p" && hasHtmlClass(el, `${rootClass}__title`));
+      const contentEl = findHtmlElement(node, (el) => hasHtmlClass(el, `${rootClass}__content`));
+      const title = titleEl ? ctx.text(titleEl).trim() : "";
+      const body = contentEl ? ctx.block(contentEl) : "";
+      return `${title ? `::${type} ${title}` : `::${type}`}
+${body}
+::`;
     };
   };
   var transformGitHubAlerts = (markdown) => {
@@ -5030,9 +5111,21 @@ ${body}
       name: "autolink",
       options: {
         autolinks: resolveAutolinkPluginOptions(options)
-      }
+      },
+      htmlToMarkdown: autolinkToMarkdown()
     });
   };
+  var autolinkToMarkdown = () => (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "a")
+      return void 0;
+    const href = node.attrs.href;
+    if (!href)
+      return void 0;
+    const extras = Object.keys(node.attrs).filter((key) => key !== "href" && key !== "target" && key !== "rel");
+    if (extras.length > 0)
+      return void 0;
+    return ctx.text(node).trim() === href ? href : void 0;
+  };
 
   // ../plugin-code-copy/dist/index.js
   var codeCopyPlugin = (options = {}) => {
@@ -5055,9 +5148,34 @@ ${body}
       },
       hooks: {
         afterParse: wrapCodeBlocks
-      }
+      },
+      htmlToMarkdown: codeCopyToMarkdown()
     });
   };
+  var codeCopyToMarkdown = () => (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "figure" || node.attrs["data-nizel-code-copy"] === void 0)
+      return void 0;
+    const source = findHtmlDescendant(node, (el) => el.tag === "textarea" && el.attrs["data-nizel-copy-source"] !== void 0);
+    if (!source) {
+      const body = htmlChildElements(node).filter((el) => !["figcaption", "textarea", "button"].includes(el.tag));
+      return ctx.block(htmlRoot(body));
+    }
+    const code = ctx.text(source).replace(/\n$/, "");
+    const pre = findHtmlDescendant(node, (el) => el.tag === "pre");
+    const codeEl = pre ? findHtmlElement(pre, (el) => el.tag === "code") : void 0;
+    const codeClass = codeEl?.attrs.class ?? "";
+    const langClass = codeClass.match(/\blanguage-([A-Za-z0-9_-]+)/)?.[1];
+    const isMermaid = findHtmlDescendant(node, (el) => el.tag === "div" && el.attrs.class === "mermaid") !== void 0;
+    const lang = langClass ?? pre?.attrs["data-language"] ?? (isMermaid ? "mermaid" : "");
+    const fence = fenceFor(code);
+    return `${fence}${lang}
+${code}
+${fence}`;
+  };
+  var fenceFor = (code) => {
+    const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
+    return "`".repeat(Math.max(3, longest + 1));
+  };
   var wrapCodeBlocks = (ast) => ({
     ...ast,
     children: ast.children.map(wrapCodeBlock)
@@ -5134,7 +5252,28 @@ ${body}
         afterParse(ast) {
           return appendBibliography(replaceCitationRefs(ast, citations), citations);
         }
+      },
+      htmlToMarkdown: citationsToMarkdown(options)
+    };
+  };
+  var citationsToMarkdown = (options = {}) => {
+    const className = options.className ?? "citations";
+    return (node, ctx) => {
+      if (node.type !== "element")
+        return void 0;
+      if (node.tag === "a" && hasHtmlClass(node, "citation")) {
+        const match = /^#cite-(.+)$/.exec(node.attrs.href ?? "");
+        return match ? `[@${match[1]}]` : void 0;
+      }
+      if (node.tag === "section" && hasHtmlClass(node, className)) {
+        const list = findHtmlElement(node, (el) => el.tag === "ol");
+        const items = list ? htmlChildElements(list).filter((el) => el.tag === "li") : [];
+        return items.map((li) => {
+          const id = /^cite-(.+)$/.exec(li.attrs.id ?? "")?.[1] ?? "";
+          return `[@${id}]: ${ctx.block(htmlRoot(li.children)).trim()}`;
+        }).join("\n");
       }
+      return void 0;
     };
   };
   var extractCitations = (markdown) => {
@@ -5236,9 +5375,28 @@ ${body}
         beforeParse(markdown) {
           return transformDefinitionLists(markdown, options);
         }
-      }
+      },
+      htmlToMarkdown: deflistToMarkdown(options)
     };
   };
+  var deflistToMarkdown = (options = {}) => (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "dl")
+      return void 0;
+    if (options.className) {
+      if (node.attrs.class !== options.className)
+        return void 0;
+    } else if (node.attrs.class !== void 0) {
+      return void 0;
+    }
+    const lines = [];
+    for (const el of htmlChildElements(node)) {
+      if (el.tag === "dt")
+        lines.push(ctx.inline(el));
+      else if (el.tag === "dd")
+        lines.push(`: ${ctx.inline(el)}`);
+    }
+    return lines.join("\n");
+  };
   var transformDefinitionLists = (markdown, _options = {}) => {
     const lines = markdown.split("\n");
     const result = [];
@@ -5325,8 +5483,23 @@ ${body}
     },
     hooks: {
       beforeParse: transformDetails
-    }
+    },
+    htmlToMarkdown: detailsToMarkdown(options)
   });
+  var detailsToMarkdown = (options = {}) => {
+    const className = options.className ?? "details";
+    return (node, ctx) => {
+      if (node.type !== "element" || node.tag !== "details" || node.attrs.class !== className)
+        return void 0;
+      const summaryEl = findHtmlElement(node, (el) => el.tag === "summary");
+      const summary = summaryEl ? ctx.text(summaryEl).trim() : "Details";
+      const body = ctx.block(htmlRoot(htmlChildElements(node).filter((el) => el.tag !== "summary"))).trim();
+      return body ? `::details ${summary}
+${body}
+::` : `::details ${summary}
+::`;
+    };
+  };
   var transformDetails = (markdown) => {
     return markdown.replace(/^:::details\s*(.*?)\s*$/gm, (_match, summary) => `::details ${summary || "Details"}`).replace(/^:::\s*$/gm, "::");
   };
@@ -5356,7 +5529,19 @@ ${body}
         afterParse(ast) {
           return transformDiagramCodes(ast, options);
         }
-      }
+      },
+      htmlToMarkdown: diagramsToMarkdown(options)
+    };
+  };
+  var diagramsToMarkdown = (options = {}) => {
+    const className = options.className ?? "mermaid";
+    return (node, ctx) => {
+      if (node.type !== "element" || node.tag !== "div" || node.attrs.class !== className)
+        return void 0;
+      const code = ctx.text(node).trim();
+      return `\`\`\`mermaid
+${code}
+\`\`\``;
     };
   };
   var transformDiagramCodes = (ast, options = {}) => ({
@@ -5501,9 +5686,45 @@ ${body}
       hooks: {
         beforeParse: transformFootnotes,
         afterParse: transformFootnoteRefs
+      },
+      htmlToMarkdown: footnotesToMarkdown(options)
+    };
+  };
+  var footnotesToMarkdown = (options = {}) => {
+    const className = options.className ?? "footnotes";
+    return (node, ctx) => {
+      if (node.type !== "element")
+        return void 0;
+      if (node.tag === "sup") {
+        const anchor = findHtmlElement(node, (el) => el.tag === "a" && hasHtmlClass(el, "footnote-ref"));
+        const match = anchor ? /^#fn-(.+)$/.exec(anchor.attrs.href ?? "") : void 0;
+        return match ? `[^${match[1]}]` : void 0;
+      }
+      if (node.tag === "section" && hasHtmlClass(node, className)) {
+        const list = findHtmlElement(node, (el) => el.tag === "ol");
+        const items = list ? htmlChildElements(list).filter((el) => el.tag === "li") : [];
+        return items.map((li) => {
+          const id = /^fn-(.+)$/.exec(li.attrs.id ?? "")?.[1] ?? "";
+          const body = ctx.block(htmlRoot(stripBackrefs(li.children, className))).trim();
+          return `[^${id}]: ${body}`;
+        }).join("\n");
       }
+      return void 0;
     };
   };
+  var stripBackrefs = (nodes, className) => {
+    const result = [];
+    for (const node of nodes) {
+      if (node.type === "element") {
+        if (hasHtmlClass(node, `${className}__backref`))
+          continue;
+        result.push({ ...node, children: stripBackrefs(node.children, className) });
+      } else {
+        result.push(node);
+      }
+    }
+    return result;
+  };
   var transformFootnotes = (markdown) => {
     const lines = markdown.split("\n");
     const body = [];
@@ -5649,9 +5870,46 @@ ${body}
         afterParse(ast) {
           return transformTaskLists(ast, mode);
         }
-      }
+      },
+      htmlToMarkdown: taskListToMarkdown()
     };
   };
+  var CHECKBOX_ATTR = "data-nizel-task-checkbox";
+  var isCheckbox = (node) => node.type === "element" && node.tag === "input" && node.attrs?.[CHECKBOX_ATTR] !== void 0;
+  var taskListToMarkdown = () => (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "ul" && node.tag !== "ol")
+      return void 0;
+    const items = htmlChildElements(node).filter((el) => el.tag === "li");
+    if (!items.some((item) => findHtmlDescendant(item, isCheckbox)))
+      return void 0;
+    const ordered = node.tag === "ol";
+    const start = Number(node.attrs.start ?? 1);
+    return items.map((item, index) => {
+      const checkbox = findHtmlDescendant(item, isCheckbox);
+      const body = ctx.block(htmlRoot(cleanTaskChildren(item.children))).trim();
+      const baseMarker = ordered ? `${start + index}. ` : "- ";
+      const marker = checkbox ? `${baseMarker}${checkbox.attrs.checked !== void 0 ? "[x] " : "[ ] "}` : baseMarker;
+      return ctx.indent(`${marker}${body}`, marker.length);
+    }).join("\n");
+  };
+  var cleanTaskChildren = (nodes) => {
+    const result = [];
+    for (const node of nodes) {
+      if (node.type === "element") {
+        if (isCheckbox(node))
+          continue;
+        const cleaned = { ...node, children: cleanTaskChildren(node.children) };
+        if (hasHtmlClass(cleaned, "nizel-task-list__label") || hasHtmlClass(cleaned, "nizel-task-list__content")) {
+          result.push(...cleaned.children);
+        } else {
+          result.push(cleaned);
+        }
+      } else {
+        result.push(node);
+      }
+    }
+    return result;
+  };
   var transformTaskLists = (ast, mode = "view") => {
     return { ...ast, children: ast.children.map((node) => transformBlock5(node, mode)) };
   };
@@ -5733,8 +5991,17 @@ ${body}
       afterParse(ast) {
         return addHeadingAnchors(ast, options);
       }
-    }
+    },
+    htmlToMarkdown: headingAnchorsToMarkdown(options)
   });
+  var headingAnchorsToMarkdown = (options = {}) => {
+    const className = options.className ?? "heading-anchor";
+    return (node) => {
+      if (node.type !== "element" || node.tag !== "a" || !hasHtmlClass(node, className))
+        return void 0;
+      return "";
+    };
+  };
   var addHeadingAnchors = (ast, options = {}) => ({
     ...ast,
     children: ast.children.map((node) => {
@@ -5766,7 +6033,26 @@ ${body}
         afterParse(ast) {
           return transformInlineMath(ast, options);
         }
+      },
+      htmlToMarkdown: mathToMarkdown(options)
+    };
+  };
+  var mathToMarkdown = (options = {}) => {
+    const inlineTokens = (options.inlineClassName ?? "math math-inline").split(/\s+/);
+    const blockTokens = (options.blockClassName ?? "math math-display").split(/\s+/);
+    return (node, ctx) => {
+      if (node.type !== "element")
+        return void 0;
+      const tokens = node.attrs.class ? node.attrs.class.split(/\s+/) : [];
+      if (node.tag === "span" && inlineTokens.every((token) => tokens.includes(token))) {
+        return `$${ctx.text(node)}$`;
+      }
+      if (node.tag === "div" && blockTokens.every((token) => tokens.includes(token))) {
+        return `$$
+${ctx.text(node).trim()}
+$$`;
       }
+      return void 0;
     };
   };
   var transformBlockMath = (markdown) => {
@@ -5869,8 +6155,26 @@ ${body}
       afterRender(html) {
         return enhanceImages(html, options);
       }
-    }
+    },
+    htmlToMarkdown: mediaToMarkdown(options)
   });
+  var mediaToMarkdown = (options = {}) => {
+    const className = options.figureClassName ?? "media-figure";
+    return (node, ctx) => {
+      if (node.type !== "element" || node.tag !== "figure" || node.attrs.class !== className)
+        return void 0;
+      const img = findHtmlElement(node, (el) => el.tag === "img");
+      if (!img)
+        return void 0;
+      const attrs = { src: img.attrs.src ?? "" };
+      if (img.attrs.alt !== void 0)
+        attrs.alt = img.attrs.alt;
+      if (img.attrs.title !== void 0)
+        attrs.title = img.attrs.title;
+      const cleanImg = { type: "element", tag: "img", attrs, children: [], raw: "" };
+      return ctx.inline({ type: "root", children: [cleanImg] });
+    };
+  };
   var enhanceImages = (html, options = {}) => {
     const lazy = options.lazy !== false;
     const responsive = options.responsive !== false;
@@ -5933,9 +6237,30 @@ ${body}
             }
           }
         }
-      }
+      },
+      htmlToMarkdown: shikiToMarkdown()
     });
   };
+  var shikiToMarkdown = () => (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "pre")
+      return void 0;
+    const isShiki = hasHtmlClass(node, "shiki") || node.attrs.style !== void 0 || node.attrs["data-language"] !== void 0;
+    if (!isShiki)
+      return void 0;
+    const codeEl = findHtmlElement(node, (el) => el.tag === "code");
+    const codeClass = codeEl?.attrs.class ?? "";
+    const langClass = codeClass.match(/\blanguage-([A-Za-z0-9_-]+)/)?.[1];
+    const lang = node.attrs["data-language"] ?? langClass ?? "";
+    const code = ctx.text(node).replace(/\n$/, "");
+    const fence = fenceFor2(code);
+    return `${fence}${lang}
+${code}
+${fence}`;
+  };
+  var fenceFor2 = (code) => {
+    const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
+    return "`".repeat(Math.max(3, longest + 1));
+  };
   var fallback = (node, ctx) => {
     const language = node.lang ? ` class="language-${ctx.escape(node.lang)}"` : "";
     return `<pre><code${language}>${ctx.escape(node.code)}</code></pre>`;
@@ -5954,8 +6279,17 @@ ${body}
       afterParse(ast) {
         return fillTocBlocks(ast, options);
       }
-    }
+    },
+    htmlToMarkdown: tocToMarkdown(options)
   });
+  var tocToMarkdown = (options = {}) => {
+    const className = options.className ?? "toc";
+    return (node) => {
+      if (node.type !== "element" || node.tag !== "nav" || !hasHtmlClass(node, className))
+        return void 0;
+      return "[[toc]]";
+    };
+  };
   var fillTocBlocks = (ast, options = {}) => {
     const minDepth = options.minDepth ?? 2;
     const maxDepth = options.maxDepth ?? 6;
@@ -5989,7 +6323,24 @@ ${body}
         afterParse(ast) {
           return transformTypography(ast, options);
         }
-      }
+      },
+      htmlToMarkdown: typographyToMarkdown(options)
+    };
+  };
+  var typographyToMarkdown = (options = {}) => {
+    const mark = options.mark !== false;
+    const subscript = options.subscript !== false;
+    const superscript = options.superscript !== false;
+    return (node, ctx) => {
+      if (node.type !== "element" || Object.keys(node.attrs).length > 0)
+        return void 0;
+      if (node.tag === "mark" && mark)
+        return `==${ctx.inline(node)}==`;
+      if (node.tag === "sub" && subscript)
+        return `~${ctx.inline(node)}~`;
+      if (node.tag === "sup" && superscript)
+        return `^${ctx.inline(node)}^`;
+      return void 0;
     };
   };
   var transformTypography = (ast, options = {}) => {

package/dist/nizel-kit.js

@@ -32,8 +32,36 @@ var blockTags = /* @__PURE__ */ new Set([
 ]);
 var passthroughInlineTags = /* @__PURE__ */ new Set(["abbr", "bdi", "bdo", "cite", "data", "dfn", "kbd", "mark", "q", "samp", "small", "sub", "sup", "time", "u", "var"]);
 function htmlToMarkdown(html, options = {}) {
+  const resolved = {
+    unsupported: options.unsupported ?? "preserve",
+    plugins: options.plugins ?? []
+  };
+  const handlers = resolved.plugins.flatMap((plugin) => {
+    const handler = plugin?.htmlToMarkdown;
+    return handler ? Array.isArray(handler) ? handler : [handler] : [];
+  });
+  const ctx = { options: resolved, handlers, epilogue: [] };
   const root = parseHtml(html);
-  return normalizeDocument(renderChildren(root.children, { unsupported: options.unsupported ?? "preserve" }, 0));
+  const body = normalizeDocument(renderChildren(root.children, ctx, 0));
+  return ctx.epilogue.length ? normalizeDocument(`${body}
+
+${ctx.epilogue.join("\n\n")}`) : body;
+}
+function buildHandlerContext(node, ctx, depth) {
+  return {
+    options: ctx.options,
+    inline: (target) => normalizeInline(renderChildren(childrenOf(target), ctx, depth)),
+    block: (target) => normalizeDocument(renderChildren(childrenOf(target), ctx, depth)),
+    text: (target) => textContent(target),
+    indent: (value, size) => indentContinuation(value, size),
+    epilogue: (value) => {
+      if (value)
+        ctx.epilogue.push(value);
+    }
+  };
+}
+function childrenOf(node) {
+  return node.type === "element" || node.type === "root" ? node.children : [];
 }
 function parseHtml(html) {
   const root = { type: "root", children: [] };
@@ -135,25 +163,31 @@ function hasUnsupportedAttrs(node) {
 function slugifyText(value) {
   return value.toLowerCase().replace(/[^\w\s-]/g, "").replace(/[\s_]+/g, "-").replace(/^-+|-+$/g, "");
 }
-function renderChildren(nodes, options, depth) {
-  return nodes.map((node) => renderNode(node, options, depth)).join("");
+function renderChildren(nodes, ctx, depth) {
+  return nodes.map((node) => renderNode(node, ctx, depth)).join("");
 }
-function renderNode(node, options, depth) {
+function renderNode(node, ctx, depth) {
   if (node.type === "text")
     return collapseText(decodeEntities(node.value));
   if (node.type === "comment")
-    return options.unsupported === "preserve" ? node.value : " ";
+    return ctx.options.unsupported === "preserve" ? node.value : " ";
   if (node.type === "root")
-    return renderChildren(node.children, options, depth);
-  const inline = () => normalizeInline(renderChildren(node.children, options, depth));
-  const block = () => normalizeDocument(renderChildren(node.children, options, depth));
-  if (options.unsupported === "preserve" && hasUnsupportedAttrs(node)) {
+    return renderChildren(node.children, ctx, depth);
+  const inline = () => normalizeInline(renderChildren(node.children, ctx, depth));
+  const block = () => normalizeDocument(renderChildren(node.children, ctx, depth));
+  for (const handler of ctx.handlers) {
+    const result = handler(node, buildHandlerContext(node, ctx, depth));
+    if (result !== void 0) {
+      return blockTags.has(node.tag) ? blockWrap(result) : result;
+    }
+  }
+  if (ctx.options.unsupported === "preserve" && hasUnsupportedAttrs(node)) {
     return blockTags.has(node.tag) ? blockWrap(node.raw) : node.raw;
   }
   if (/^h[1-6]$/.test(node.tag))
     return blockWrap(`${"#".repeat(Number(node.tag[1]))} ${inline()}`);
   if (node.tag === "p")
-    return blockWrap(normalizeParagraph(renderChildren(node.children, options, depth)));
+    return blockWrap(normalizeParagraph(renderChildren(node.children, ctx, depth)));
   if (node.tag === "br")
     return "  \n";
   if (node.tag === "hr")
@@ -175,13 +209,13 @@ function renderNode(node, options, depth) {
   if (node.tag === "blockquote")
     return blockWrap(prefixLines(block(), "> "));
   if (node.tag === "ul" || node.tag === "ol")
-    return blockWrap(renderList(node, options, depth));
+    return blockWrap(renderList(node, ctx, depth));
   if (node.tag === "li")
     return inline();
   if (node.tag === "table") {
-    if (options.unsupported === "preserve" && tableHasUnsupportedStructure(node))
+    if (ctx.options.unsupported === "preserve" && tableHasUnsupportedStructure(node))
       return blockWrap(node.raw);
-    return blockWrap(renderTable(node, options));
+    return blockWrap(renderTable(node, ctx));
   }
   if (node.tag === "thead" || node.tag === "tbody" || node.tag === "tr" || node.tag === "th" || node.tag === "td")
     return inline();
@@ -190,9 +224,9 @@ function renderNode(node, options, depth) {
   if (node.tag === "span")
     return inline();
   if (passthroughInlineTags.has(node.tag) || blockTags.has(node.tag)) {
-    return options.unsupported === "preserve" ? node.raw : block();
+    return ctx.options.unsupported === "preserve" ? node.raw : block();
   }
-  return options.unsupported === "preserve" ? node.raw : inline();
+  return ctx.options.unsupported === "preserve" ? node.raw : inline();
 }
 function renderLink(node, text) {
   const href = node.attrs.href;
@@ -225,19 +259,19 @@ function renderCodeBlock(node) {
 ${code}
 ${fence}`;
 }
-function renderList(node, options, depth) {
+function renderList(node, ctx, depth) {
   return node.children.filter((child) => child.type === "element" && child.tag === "li").map((item, index) => {
     const marker = node.tag === "ol" ? `${Number(node.attrs.start ?? 1) + index}. ` : "- ";
-    const body = normalizeListItemBody(renderChildren(item.children, options, depth + 1));
+    const body = normalizeListItemBody(renderChildren(item.children, ctx, depth + 1));
     return indentContinuation(`${marker}${body}`, marker.length);
   }).join("\n");
 }
-function renderTable(node, options) {
+function renderTable(node, ctx) {
   const rows = collectRows(node).map((row) => row.children.filter((cell) => cell.type === "element" && (cell.tag === "th" || cell.tag === "td"))).filter((row) => row.length > 0);
   if (rows.length === 0)
     return "";
   const width = Math.max(...rows.map((row) => row.length));
-  const values = rows.map((row) => Array.from({ length: width }, (_, index) => normalizeInline(renderChildren(row[index]?.children ?? [], options, 0))));
+  const values = rows.map((row) => Array.from({ length: width }, (_, index) => normalizeInline(renderChildren(row[index]?.children ?? [], ctx, 0))));
   const header = values[0];
   const separator = Array.from({ length: width }, () => "---");
   const body = values.slice(1);
@@ -334,6 +368,20 @@ function longestRun(value, char) {
   }
   return longest;
 }
+var htmlChildElements = (node) => node.type === "element" || node.type === "root" ? node.children.filter((child) => child.type === "element") : [];
+var findHtmlElement = (node, predicate) => htmlChildElements(node).find(predicate);
+var hasHtmlClass = (node, className) => node.type === "element" && (node.attrs.class ?? "").split(/\s+/).includes(className);
+var findHtmlDescendant = (node, predicate) => {
+  for (const child of htmlChildElements(node)) {
+    if (predicate(child))
+      return child;
+    const nested = findHtmlDescendant(child, predicate);
+    if (nested)
+      return nested;
+  }
+  return void 0;
+};
+var htmlRoot = (children) => ({ type: "root", children });
 
 // ../nizel/dist/collect.js
 function collect(ast) {
@@ -4845,7 +4893,22 @@ var abbrPlugin = (options = {}) => {
       afterParse(ast) {
         return replaceAbbreviations(ast, definitions);
       }
-    }
+    },
+    htmlToMarkdown: abbrToMarkdown()
+  };
+};
+var abbrToMarkdown = () => {
+  const seen = /* @__PURE__ */ new Set();
+  return (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "abbr")
+      return void 0;
+    const term = ctx.text(node).trim();
+    const title = node.attrs.title;
+    if (title !== void 0 && term && !seen.has(term)) {
+      seen.add(term);
+      ctx.epilogue(`*[${term}]: ${title}`);
+    }
+    return term;
   };
 };
 var extractAbbreviations = (markdown) => {
@@ -4913,7 +4976,25 @@ var alertPlugin = (options = {}) => {
     blocks,
     hooks: {
       beforeParse: transformGitHubAlerts
-    }
+    },
+    htmlToMarkdown: alertToMarkdown(options)
+  };
+};
+var alertToMarkdown = (options = {}) => {
+  const rootClass = options.className ?? "alert";
+  return (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "div")
+      return void 0;
+    const type = node.attrs["data-alert"];
+    if (!type)
+      return void 0;
+    const titleEl = findHtmlElement(node, (el) => el.tag === "p" && hasHtmlClass(el, `${rootClass}__title`));
+    const contentEl = findHtmlElement(node, (el) => hasHtmlClass(el, `${rootClass}__content`));
+    const title = titleEl ? ctx.text(titleEl).trim() : "";
+    const body = contentEl ? ctx.block(contentEl) : "";
+    return `${title ? `::${type} ${title}` : `::${type}`}
+${body}
+::`;
   };
 };
 var transformGitHubAlerts = (markdown) => {
@@ -4998,9 +5079,21 @@ var autolinkPlugin = (options = {}) => {
     name: "autolink",
     options: {
       autolinks: resolveAutolinkPluginOptions(options)
-    }
+    },
+    htmlToMarkdown: autolinkToMarkdown()
   });
 };
+var autolinkToMarkdown = () => (node, ctx) => {
+  if (node.type !== "element" || node.tag !== "a")
+    return void 0;
+  const href = node.attrs.href;
+  if (!href)
+    return void 0;
+  const extras = Object.keys(node.attrs).filter((key) => key !== "href" && key !== "target" && key !== "rel");
+  if (extras.length > 0)
+    return void 0;
+  return ctx.text(node).trim() === href ? href : void 0;
+};
 
 // ../plugin-code-copy/dist/index.js
 var codeCopyPlugin = (options = {}) => {
@@ -5023,9 +5116,34 @@ var codeCopyPlugin = (options = {}) => {
     },
     hooks: {
       afterParse: wrapCodeBlocks
-    }
+    },
+    htmlToMarkdown: codeCopyToMarkdown()
   });
 };
+var codeCopyToMarkdown = () => (node, ctx) => {
+  if (node.type !== "element" || node.tag !== "figure" || node.attrs["data-nizel-code-copy"] === void 0)
+    return void 0;
+  const source = findHtmlDescendant(node, (el) => el.tag === "textarea" && el.attrs["data-nizel-copy-source"] !== void 0);
+  if (!source) {
+    const body = htmlChildElements(node).filter((el) => !["figcaption", "textarea", "button"].includes(el.tag));
+    return ctx.block(htmlRoot(body));
+  }
+  const code = ctx.text(source).replace(/\n$/, "");
+  const pre = findHtmlDescendant(node, (el) => el.tag === "pre");
+  const codeEl = pre ? findHtmlElement(pre, (el) => el.tag === "code") : void 0;
+  const codeClass = codeEl?.attrs.class ?? "";
+  const langClass = codeClass.match(/\blanguage-([A-Za-z0-9_-]+)/)?.[1];
+  const isMermaid = findHtmlDescendant(node, (el) => el.tag === "div" && el.attrs.class === "mermaid") !== void 0;
+  const lang = langClass ?? pre?.attrs["data-language"] ?? (isMermaid ? "mermaid" : "");
+  const fence = fenceFor(code);
+  return `${fence}${lang}
+${code}
+${fence}`;
+};
+var fenceFor = (code) => {
+  const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
+  return "`".repeat(Math.max(3, longest + 1));
+};
 var wrapCodeBlocks = (ast) => ({
   ...ast,
   children: ast.children.map(wrapCodeBlock)
@@ -5102,7 +5220,28 @@ var citationsPlugin = (options = {}) => {
       afterParse(ast) {
         return appendBibliography(replaceCitationRefs(ast, citations), citations);
       }
+    },
+    htmlToMarkdown: citationsToMarkdown(options)
+  };
+};
+var citationsToMarkdown = (options = {}) => {
+  const className = options.className ?? "citations";
+  return (node, ctx) => {
+    if (node.type !== "element")
+      return void 0;
+    if (node.tag === "a" && hasHtmlClass(node, "citation")) {
+      const match = /^#cite-(.+)$/.exec(node.attrs.href ?? "");
+      return match ? `[@${match[1]}]` : void 0;
+    }
+    if (node.tag === "section" && hasHtmlClass(node, className)) {
+      const list = findHtmlElement(node, (el) => el.tag === "ol");
+      const items = list ? htmlChildElements(list).filter((el) => el.tag === "li") : [];
+      return items.map((li) => {
+        const id = /^cite-(.+)$/.exec(li.attrs.id ?? "")?.[1] ?? "";
+        return `[@${id}]: ${ctx.block(htmlRoot(li.children)).trim()}`;
+      }).join("\n");
     }
+    return void 0;
   };
 };
 var extractCitations = (markdown) => {
@@ -5204,9 +5343,28 @@ var deflistPlugin = (options = {}) => {
       beforeParse(markdown) {
         return transformDefinitionLists(markdown, options);
       }
-    }
+    },
+    htmlToMarkdown: deflistToMarkdown(options)
   };
 };
+var deflistToMarkdown = (options = {}) => (node, ctx) => {
+  if (node.type !== "element" || node.tag !== "dl")
+    return void 0;
+  if (options.className) {
+    if (node.attrs.class !== options.className)
+      return void 0;
+  } else if (node.attrs.class !== void 0) {
+    return void 0;
+  }
+  const lines = [];
+  for (const el of htmlChildElements(node)) {
+    if (el.tag === "dt")
+      lines.push(ctx.inline(el));
+    else if (el.tag === "dd")
+      lines.push(`: ${ctx.inline(el)}`);
+  }
+  return lines.join("\n");
+};
 var transformDefinitionLists = (markdown, _options = {}) => {
   const lines = markdown.split("\n");
   const result = [];
@@ -5293,8 +5451,23 @@ var detailsPlugin = (options = {}) => ({
   },
   hooks: {
     beforeParse: transformDetails
-  }
+  },
+  htmlToMarkdown: detailsToMarkdown(options)
 });
+var detailsToMarkdown = (options = {}) => {
+  const className = options.className ?? "details";
+  return (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "details" || node.attrs.class !== className)
+      return void 0;
+    const summaryEl = findHtmlElement(node, (el) => el.tag === "summary");
+    const summary = summaryEl ? ctx.text(summaryEl).trim() : "Details";
+    const body = ctx.block(htmlRoot(htmlChildElements(node).filter((el) => el.tag !== "summary"))).trim();
+    return body ? `::details ${summary}
+${body}
+::` : `::details ${summary}
+::`;
+  };
+};
 var transformDetails = (markdown) => {
   return markdown.replace(/^:::details\s*(.*?)\s*$/gm, (_match, summary) => `::details ${summary || "Details"}`).replace(/^:::\s*$/gm, "::");
 };
@@ -5324,7 +5497,19 @@ var diagramsPlugin = (options = {}) => {
       afterParse(ast) {
         return transformDiagramCodes(ast, options);
       }
-    }
+    },
+    htmlToMarkdown: diagramsToMarkdown(options)
+  };
+};
+var diagramsToMarkdown = (options = {}) => {
+  const className = options.className ?? "mermaid";
+  return (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "div" || node.attrs.class !== className)
+      return void 0;
+    const code = ctx.text(node).trim();
+    return `\`\`\`mermaid
+${code}
+\`\`\``;
   };
 };
 var transformDiagramCodes = (ast, options = {}) => ({
@@ -5469,9 +5654,45 @@ var footnotesPlugin = (options = {}) => {
     hooks: {
       beforeParse: transformFootnotes,
       afterParse: transformFootnoteRefs
+    },
+    htmlToMarkdown: footnotesToMarkdown(options)
+  };
+};
+var footnotesToMarkdown = (options = {}) => {
+  const className = options.className ?? "footnotes";
+  return (node, ctx) => {
+    if (node.type !== "element")
+      return void 0;
+    if (node.tag === "sup") {
+      const anchor = findHtmlElement(node, (el) => el.tag === "a" && hasHtmlClass(el, "footnote-ref"));
+      const match = anchor ? /^#fn-(.+)$/.exec(anchor.attrs.href ?? "") : void 0;
+      return match ? `[^${match[1]}]` : void 0;
+    }
+    if (node.tag === "section" && hasHtmlClass(node, className)) {
+      const list = findHtmlElement(node, (el) => el.tag === "ol");
+      const items = list ? htmlChildElements(list).filter((el) => el.tag === "li") : [];
+      return items.map((li) => {
+        const id = /^fn-(.+)$/.exec(li.attrs.id ?? "")?.[1] ?? "";
+        const body = ctx.block(htmlRoot(stripBackrefs(li.children, className))).trim();
+        return `[^${id}]: ${body}`;
+      }).join("\n");
     }
+    return void 0;
   };
 };
+var stripBackrefs = (nodes, className) => {
+  const result = [];
+  for (const node of nodes) {
+    if (node.type === "element") {
+      if (hasHtmlClass(node, `${className}__backref`))
+        continue;
+      result.push({ ...node, children: stripBackrefs(node.children, className) });
+    } else {
+      result.push(node);
+    }
+  }
+  return result;
+};
 var transformFootnotes = (markdown) => {
   const lines = markdown.split("\n");
   const body = [];
@@ -5617,9 +5838,46 @@ var taskListPlugin = (options = {}) => {
       afterParse(ast) {
         return transformTaskLists(ast, mode);
       }
-    }
+    },
+    htmlToMarkdown: taskListToMarkdown()
   };
 };
+var CHECKBOX_ATTR = "data-nizel-task-checkbox";
+var isCheckbox = (node) => node.type === "element" && node.tag === "input" && node.attrs?.[CHECKBOX_ATTR] !== void 0;
+var taskListToMarkdown = () => (node, ctx) => {
+  if (node.type !== "element" || node.tag !== "ul" && node.tag !== "ol")
+    return void 0;
+  const items = htmlChildElements(node).filter((el) => el.tag === "li");
+  if (!items.some((item) => findHtmlDescendant(item, isCheckbox)))
+    return void 0;
+  const ordered = node.tag === "ol";
+  const start = Number(node.attrs.start ?? 1);
+  return items.map((item, index) => {
+    const checkbox = findHtmlDescendant(item, isCheckbox);
+    const body = ctx.block(htmlRoot(cleanTaskChildren(item.children))).trim();
+    const baseMarker = ordered ? `${start + index}. ` : "- ";
+    const marker = checkbox ? `${baseMarker}${checkbox.attrs.checked !== void 0 ? "[x] " : "[ ] "}` : baseMarker;
+    return ctx.indent(`${marker}${body}`, marker.length);
+  }).join("\n");
+};
+var cleanTaskChildren = (nodes) => {
+  const result = [];
+  for (const node of nodes) {
+    if (node.type === "element") {
+      if (isCheckbox(node))
+        continue;
+      const cleaned = { ...node, children: cleanTaskChildren(node.children) };
+      if (hasHtmlClass(cleaned, "nizel-task-list__label") || hasHtmlClass(cleaned, "nizel-task-list__content")) {
+        result.push(...cleaned.children);
+      } else {
+        result.push(cleaned);
+      }
+    } else {
+      result.push(node);
+    }
+  }
+  return result;
+};
 var transformTaskLists = (ast, mode = "view") => {
   return { ...ast, children: ast.children.map((node) => transformBlock5(node, mode)) };
 };
@@ -5701,8 +5959,17 @@ var headingAnchorsPlugin = (options = {}) => ({
     afterParse(ast) {
       return addHeadingAnchors(ast, options);
     }
-  }
+  },
+  htmlToMarkdown: headingAnchorsToMarkdown(options)
 });
+var headingAnchorsToMarkdown = (options = {}) => {
+  const className = options.className ?? "heading-anchor";
+  return (node) => {
+    if (node.type !== "element" || node.tag !== "a" || !hasHtmlClass(node, className))
+      return void 0;
+    return "";
+  };
+};
 var addHeadingAnchors = (ast, options = {}) => ({
   ...ast,
   children: ast.children.map((node) => {
@@ -5734,7 +6001,26 @@ var mathPlugin = (options = {}) => {
       afterParse(ast) {
         return transformInlineMath(ast, options);
       }
+    },
+    htmlToMarkdown: mathToMarkdown(options)
+  };
+};
+var mathToMarkdown = (options = {}) => {
+  const inlineTokens = (options.inlineClassName ?? "math math-inline").split(/\s+/);
+  const blockTokens = (options.blockClassName ?? "math math-display").split(/\s+/);
+  return (node, ctx) => {
+    if (node.type !== "element")
+      return void 0;
+    const tokens = node.attrs.class ? node.attrs.class.split(/\s+/) : [];
+    if (node.tag === "span" && inlineTokens.every((token) => tokens.includes(token))) {
+      return `$${ctx.text(node)}$`;
+    }
+    if (node.tag === "div" && blockTokens.every((token) => tokens.includes(token))) {
+      return `$$
+${ctx.text(node).trim()}
+$$`;
     }
+    return void 0;
   };
 };
 var transformBlockMath = (markdown) => {
@@ -5837,8 +6123,26 @@ var mediaPlugin = (options = {}) => ({
     afterRender(html) {
       return enhanceImages(html, options);
     }
-  }
+  },
+  htmlToMarkdown: mediaToMarkdown(options)
 });
+var mediaToMarkdown = (options = {}) => {
+  const className = options.figureClassName ?? "media-figure";
+  return (node, ctx) => {
+    if (node.type !== "element" || node.tag !== "figure" || node.attrs.class !== className)
+      return void 0;
+    const img = findHtmlElement(node, (el) => el.tag === "img");
+    if (!img)
+      return void 0;
+    const attrs = { src: img.attrs.src ?? "" };
+    if (img.attrs.alt !== void 0)
+      attrs.alt = img.attrs.alt;
+    if (img.attrs.title !== void 0)
+      attrs.title = img.attrs.title;
+    const cleanImg = { type: "element", tag: "img", attrs, children: [], raw: "" };
+    return ctx.inline({ type: "root", children: [cleanImg] });
+  };
+};
 var enhanceImages = (html, options = {}) => {
   const lazy = options.lazy !== false;
   const responsive = options.responsive !== false;
@@ -5901,9 +6205,30 @@ var shikiPlugin = (options = {}) => {
           }
         }
       }
-    }
+    },
+    htmlToMarkdown: shikiToMarkdown()
   });
 };
+var shikiToMarkdown = () => (node, ctx) => {
+  if (node.type !== "element" || node.tag !== "pre")
+    return void 0;
+  const isShiki = hasHtmlClass(node, "shiki") || node.attrs.style !== void 0 || node.attrs["data-language"] !== void 0;
+  if (!isShiki)
+    return void 0;
+  const codeEl = findHtmlElement(node, (el) => el.tag === "code");
+  const codeClass = codeEl?.attrs.class ?? "";
+  const langClass = codeClass.match(/\blanguage-([A-Za-z0-9_-]+)/)?.[1];
+  const lang = node.attrs["data-language"] ?? langClass ?? "";
+  const code = ctx.text(node).replace(/\n$/, "");
+  const fence = fenceFor2(code);
+  return `${fence}${lang}
+${code}
+${fence}`;
+};
+var fenceFor2 = (code) => {
+  const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
+  return "`".repeat(Math.max(3, longest + 1));
+};
 var fallback = (node, ctx) => {
   const language = node.lang ? ` class="language-${ctx.escape(node.lang)}"` : "";
   return `<pre><code${language}>${ctx.escape(node.code)}</code></pre>`;
@@ -5922,8 +6247,17 @@ var tocPlugin = (options = {}) => ({
     afterParse(ast) {
       return fillTocBlocks(ast, options);
     }
-  }
+  },
+  htmlToMarkdown: tocToMarkdown(options)
 });
+var tocToMarkdown = (options = {}) => {
+  const className = options.className ?? "toc";
+  return (node) => {
+    if (node.type !== "element" || node.tag !== "nav" || !hasHtmlClass(node, className))
+      return void 0;
+    return "[[toc]]";
+  };
+};
 var fillTocBlocks = (ast, options = {}) => {
   const minDepth = options.minDepth ?? 2;
   const maxDepth = options.maxDepth ?? 6;
@@ -5957,7 +6291,24 @@ var typographyPlugin = (options = {}) => {
       afterParse(ast) {
         return transformTypography(ast, options);
       }
-    }
+    },
+    htmlToMarkdown: typographyToMarkdown(options)
+  };
+};
+var typographyToMarkdown = (options = {}) => {
+  const mark = options.mark !== false;
+  const subscript = options.subscript !== false;
+  const superscript = options.superscript !== false;
+  return (node, ctx) => {
+    if (node.type !== "element" || Object.keys(node.attrs).length > 0)
+      return void 0;
+    if (node.tag === "mark" && mark)
+      return `==${ctx.inline(node)}==`;
+    if (node.tag === "sub" && subscript)
+      return `~${ctx.inline(node)}~`;
+    if (node.tag === "sup" && superscript)
+      return `^${ctx.inline(node)}^`;
+    return void 0;
   };
 };
 var transformTypography = (ast, options = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nizel-kit",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Browser and native WebView integration kit for Nizel with official plugin registry.",
   "repository": {
     "type": "git",