markdown-codec 4.0.15 → 4.1.0

package/dist/emit/emit.cjs

@@ -10,6 +10,9 @@ const require_emit_image = require("./image.cjs");
 const require_emit_table = require("./table.cjs");
 let document_schema_js = require("document-schema.js");
 //#region src/emit/emit.ts
+function isDataUri(destination) {
+	return destination.startsWith("data:");
+}
 const MAX_SETEXT_LEVEL = 2;
 const SETEXT_LEVEL_1_CHAR = "=";
 const SETEXT_LEVEL_2_CHAR = "-";
@@ -52,9 +55,12 @@ function renderParagraphBody(paragraph, context) {
 	if (paragraph.styleId === "CodeBlock") {
 		const literal = paragraph.runs.map((run) => run.text).join("");
 		const fence = codeFenceFor(literal, context.codeFenceChar);
-		return literal.length === 0 ? `${fence}\n${fence}` : `${fence}\n${literal}\n${fence}`;
+		const remainder = paragraph.source?.format === "markdown" ? paragraph.source.xml : void 0;
+		const info = [paragraph.codeLanguage, remainder].filter((part) => part !== void 0 && part.length > 0).join(" ");
+		const opening = info.length > 0 ? `${fence} ${info}` : fence;
+		return literal.length === 0 ? `${opening}\n${fence}` : `${opening}\n${literal}\n${fence}`;
 	}
-	if (paragraph.styleId === "HTMLPreformatted") return paragraph.runs.map((run) => run.text).join("");
+	if (paragraph.styleId === "HTMLPreformatted") return paragraph.source?.format === "markdown" ? paragraph.source.xml : paragraph.runs.map((run) => run.text).join("");
 	if (paragraph.styleId === "MathBlock") return `$$\n${paragraph.runs.map((run) => run.text).join("")}\n$$`;
 	const headingLevel = paragraph.styleId === void 0 ? void 0 : require_shared_style_constants.parseHeadingStyleId(paragraph.styleId);
 	if (headingLevel !== void 0) {
@@ -64,15 +70,15 @@ function renderParagraphBody(paragraph, context) {
 			severity: "info",
 			message: `heading level ${String(headingLevel)} exceeds ATX's own six-"#" ceiling and is clamped to ${String(level)}`
 		});
-		const text = require_emit_inline.emitRuns(paragraph.runs, context);
+		const text = require_emit_inline.emitRuns(paragraph.runs, context, paragraph.constructs);
 		if (context.headingStyle === "setext" && level <= MAX_SETEXT_LEVEL) return renderSetextHeading(level, text);
 		return `${"#".repeat(level)} ${text}`;
 	}
-	return require_emit_inline.emitRuns(paragraph.runs, context);
+	return require_emit_inline.emitRuns(paragraph.runs, context, paragraph.constructs);
 }
 function renderParagraph(paragraph, context) {
 	const body = renderParagraphBody(paragraph, context);
-	const depth = quoteDepthOf(paragraph);
+	const depth = context.divisionDepth > 0 ? 0 : quoteDepthOf(paragraph);
 	if (depth === 0) return body;
 	if (!isQuotableStyle(paragraph.styleId)) {
 		context.sink({
@@ -90,8 +96,13 @@ function renderTopLevelBlock(block, context) {
 		case "paragraph": return renderParagraph(block, context);
 		case "table": return require_emit_table.emitTable(block, context);
 		case "image": return require_emit_image.emitImage(block, context.embedImages);
-		case "pageBreak":
-		case "embeddedObject": return "";
+		case "embeddedObject":
+			if (block.objectKind === "formula" && block.document.kind === "formula" && block.document.formula.presentation !== void 0) {
+				const latex = block.document.formula.presentation.latex;
+				return latex.length === 0 ? "$$\n$$" : `$$\n${latex}\n$$`;
+			}
+			return "";
+		case "pageBreak": return "";
 	}
 }
 function listInfoFor(numId, context) {
@@ -117,16 +128,9 @@ function listInfoFor(numId, context) {
 	}
 	return info;
 }
-function checkboxPrefixFor(item) {
-	const first = item.runs[0];
-	if (first === void 0) return;
-	if (first.text.startsWith(`☒ `)) return "[x] ";
-	if (first.text.startsWith(`☐ `)) return "[ ] ";
-}
-function stripCheckboxRun(item, checkboxPrefix) {
-	if (checkboxPrefix === void 0) return item;
+function stripCheckboxRun(item) {
 	const first = item.runs[0];
-	const glyphPrefix = checkboxPrefix === "[x] " ? `☒ ` : `☐ `;
+	const glyphPrefix = first?.text.startsWith(`☒ `) ? `☒ ` : `☐ `;
 	if (!first?.text.startsWith(glyphPrefix)) return item;
 	const strippedText = first.text.slice(glyphPrefix.length);
 	const runs = strippedText.length === 0 ? item.runs.slice(1) : [{
@@ -138,8 +142,30 @@ function stripCheckboxRun(item, checkboxPrefix) {
 		runs
 	};
 }
-function renderListItemMarker(numId, info, item, context) {
-	const checkboxText = (info?.task === true ? checkboxPrefixFor(item) : void 0) ?? "";
+function firstBlockCheckbox(first, taskNumId) {
+	if (first.list?.checked !== void 0) return {
+		checkboxText: first.list.checked ? "[x] " : "[ ] ",
+		stripGlyph: false
+	};
+	if (!taskNumId) return {
+		checkboxText: "",
+		stripGlyph: false
+	};
+	const leading = first.runs[0]?.text ?? "";
+	if (leading.startsWith(`☒ `)) return {
+		checkboxText: "[x] ",
+		stripGlyph: true
+	};
+	if (leading.startsWith(`☐ `)) return {
+		checkboxText: "[ ] ",
+		stripGlyph: true
+	};
+	return {
+		checkboxText: "",
+		stripGlyph: false
+	};
+}
+function renderListItemMarker(numId, info, checkboxText, context) {
 	if (info?.type === "ordered" && numId !== void 0) {
 		const next = context.orderedCounters.get(numId) ?? info.start ?? 1;
 		context.orderedCounters.set(numId, next + 1);
@@ -161,17 +187,29 @@ function renderListRegion(items, context) {
 	while (index < items.length) {
 		const item = items[index];
 		if (item?.list === void 0) break;
-		const { numId, level } = item.list;
+		const { numId, level, itemId } = item.list;
 		const info = listInfoFor(numId, context);
-		let lookahead = index + 1;
+		let ownEnd = index + 1;
+		if (itemId !== void 0) while (ownEnd < items.length) {
+			const candidate = items[ownEnd];
+			if (candidate?.list?.level !== level || candidate.list?.itemId !== itemId) break;
+			ownEnd += 1;
+		}
+		const ownBlocks = items.slice(index, ownEnd);
+		let lookahead = ownEnd;
 		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
-		const nestedItems = items.slice(index + 1, lookahead);
-		const checkboxPrefix = info?.task === true ? checkboxPrefixFor(item) : void 0;
-		const marker = renderListItemMarker(numId, info, item, context);
-		const bodyLines = renderParagraphBody(stripCheckboxRun(item, checkboxPrefix), context).split("\n");
+		const nestedItems = items.slice(ownEnd, lookahead);
+		const first = ownBlocks[0];
+		if (first === void 0) break;
+		const { checkboxText, stripGlyph } = firstBlockCheckbox(first, info?.task === true);
+		const marker = renderListItemMarker(numId, info, checkboxText, context);
 		const indent = " ".repeat(marker.bareLength);
-		const [firstLine = "", ...restLines] = bodyLines;
+		const [firstLine = "", ...restLines] = renderParagraphBody(stripGlyph ? stripCheckboxRun(first) : first, context).split("\n");
 		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+		for (const extra of ownBlocks.slice(1)) {
+			const rendered = renderParagraphBody(extra, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+			text += `\n\n${rendered}`;
+		}
 		if (nestedItems.length > 0) {
 			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
 			text += `\n${nested}`;
@@ -233,9 +271,9 @@ function renderFootnoteDefinition(name, body) {
 	return [`${marker} ${firstLine}`, ...restLines.map((line) => line.length === 0 ? line : `${indent}${line}`)].join("\n");
 }
 function renderConstruct(item, context) {
-	const body = renderItems(item.children, context);
 	const { descriptor } = item;
 	if (descriptor.kind === "anchor" && descriptor.anchorType === "footnote") {
+		const body = renderItems(item.children, context);
 		if (require_inline_footnote.isValidFootnoteLabel(descriptor.name)) return renderFootnoteDefinition(descriptor.name, body);
 		context.sink({
 			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
@@ -244,6 +282,23 @@ function renderConstruct(item, context) {
 		});
 		return body;
 	}
+	if (descriptor.kind === "division") {
+		if (item.children.every((child) => {
+			if (isConstructItem(child)) return true;
+			return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
+		})) {
+			context.divisionDepth += 1;
+			const body = renderItems(item.children, context);
+			context.divisionDepth -= 1;
+			return body.split("\n").map((line) => line.length === 0 ? ">" : `> ${line}`).join("\n");
+		}
+	}
+	if (descriptor.kind === "link" && descriptor.target.kind === "external") {
+		const onlyChild = item.children.length === 1 && !isConstructItem(item.children[0]) ? item.children[0].block : void 0;
+		if (onlyChild?.kind === "image" && !isDataUri(descriptor.target.uri)) return `![${require_emit_inline.escapeMarkdownText(onlyChild.altText ?? "")}](${require_emit_inline.escapeLinkDestination(descriptor.target.uri)}${descriptor.title === void 0 ? "" : ` "${require_emit_inline.renderLinkTitle(descriptor.title)}"`})`;
+		if (onlyChild?.kind === "image" && isDataUri(descriptor.target.uri) && !context.embedImages) return require_emit_image.emitImage(onlyChild, false);
+	}
+	const body = renderItems(item.children, context);
 	const detail = descriptor.kind === "anchor" ? `${descriptor.kind} (${descriptor.anchorType})` : descriptor.kind;
 	context.sink({
 		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
@@ -284,8 +339,18 @@ function renderItems(items, context) {
 function emitBlocks(blocks, context) {
 	const imbalance = (0, document_schema_js.findConstructMarkerImbalance)(blocks);
 	if (imbalance !== void 0) throw new require_diagnostics_diagnostics.MarkdownUnbalancedConstructMarkersError(imbalance.kind, imbalance.index);
+	validateRunConstructExtents(blocks);
 	return renderItems(groupConstructItems(blocks, 0).items, context);
 }
+function validateRunConstructExtents(blocks) {
+	for (const block of blocks) {
+		if (block.kind === "paragraph" && block.constructs !== void 0) {
+			const fault = (0, document_schema_js.findRunConstructFault)(block);
+			if (fault !== void 0) throw new require_diagnostics_diagnostics.MarkdownInvalidRunConstructExtentError(fault.kind, fault.index);
+		}
+		if (block.kind === "table") for (const row of block.rows) for (const cell of row.cells) validateRunConstructExtents(cell.blocks);
+	}
+}
 function emitMarkdown(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError(document.kind);
 	const context = {
@@ -299,7 +364,8 @@ function emitMarkdown(document, options = {}) {
 		embedImages: options.images ?? true,
 		orderedCounters: /* @__PURE__ */ new Map(),
 		reportedFallbackNumIds: /* @__PURE__ */ new Set(),
-		reportedAbsentNumIdFallback: false
+		reportedAbsentNumIdFallback: false,
+		divisionDepth: 0
 	};
 	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
 	const frontMatter = options.frontMatter === true ? require_emit_front_matter.emitFrontMatter(document.metadata) : void 0;

package/dist/emit/emit.js

@@ -1,14 +1,17 @@
 import { isValidFootnoteLabel } from "../inline/footnote.js";
 import "../defaults/defaults.js";
-import { MarkdownDiagnosticCodes, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
+import { MarkdownDiagnosticCodes, MarkdownInvalidRunConstructExtentError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
 import { parseListNumId } from "../shared/list-id.js";
 import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, QUOTE_STYLE_ID, parseHeadingStyleId } from "../shared/style-constants.js";
 import { emitFrontMatter } from "./front-matter.js";
-import { emitRuns } from "./inline.js";
+import { emitRuns, escapeLinkDestination, escapeMarkdownText, renderLinkTitle } from "./inline.js";
 import { emitImage } from "./image.js";
 import { emitTable } from "./table.js";
-import { clampHeadingLevel, findConstructMarkerImbalance } from "document-schema.js";
+import { clampHeadingLevel, findConstructMarkerImbalance, findRunConstructFault } from "document-schema.js";
 //#region src/emit/emit.ts
+function isDataUri(destination) {
+	return destination.startsWith("data:");
+}
 const MAX_SETEXT_LEVEL = 2;
 const SETEXT_LEVEL_1_CHAR = "=";
 const SETEXT_LEVEL_2_CHAR = "-";
@@ -51,9 +54,12 @@ function renderParagraphBody(paragraph, context) {
 	if (paragraph.styleId === "CodeBlock") {
 		const literal = paragraph.runs.map((run) => run.text).join("");
 		const fence = codeFenceFor(literal, context.codeFenceChar);
-		return literal.length === 0 ? `${fence}\n${fence}` : `${fence}\n${literal}\n${fence}`;
+		const remainder = paragraph.source?.format === "markdown" ? paragraph.source.xml : void 0;
+		const info = [paragraph.codeLanguage, remainder].filter((part) => part !== void 0 && part.length > 0).join(" ");
+		const opening = info.length > 0 ? `${fence} ${info}` : fence;
+		return literal.length === 0 ? `${opening}\n${fence}` : `${opening}\n${literal}\n${fence}`;
 	}
-	if (paragraph.styleId === "HTMLPreformatted") return paragraph.runs.map((run) => run.text).join("");
+	if (paragraph.styleId === "HTMLPreformatted") return paragraph.source?.format === "markdown" ? paragraph.source.xml : paragraph.runs.map((run) => run.text).join("");
 	if (paragraph.styleId === "MathBlock") return `$$\n${paragraph.runs.map((run) => run.text).join("")}\n$$`;
 	const headingLevel = paragraph.styleId === void 0 ? void 0 : parseHeadingStyleId(paragraph.styleId);
 	if (headingLevel !== void 0) {
@@ -63,15 +69,15 @@ function renderParagraphBody(paragraph, context) {
 			severity: "info",
 			message: `heading level ${String(headingLevel)} exceeds ATX's own six-"#" ceiling and is clamped to ${String(level)}`
 		});
-		const text = emitRuns(paragraph.runs, context);
+		const text = emitRuns(paragraph.runs, context, paragraph.constructs);
 		if (context.headingStyle === "setext" && level <= MAX_SETEXT_LEVEL) return renderSetextHeading(level, text);
 		return `${"#".repeat(level)} ${text}`;
 	}
-	return emitRuns(paragraph.runs, context);
+	return emitRuns(paragraph.runs, context, paragraph.constructs);
 }
 function renderParagraph(paragraph, context) {
 	const body = renderParagraphBody(paragraph, context);
-	const depth = quoteDepthOf(paragraph);
+	const depth = context.divisionDepth > 0 ? 0 : quoteDepthOf(paragraph);
 	if (depth === 0) return body;
 	if (!isQuotableStyle(paragraph.styleId)) {
 		context.sink({
@@ -89,8 +95,13 @@ function renderTopLevelBlock(block, context) {
 		case "paragraph": return renderParagraph(block, context);
 		case "table": return emitTable(block, context);
 		case "image": return emitImage(block, context.embedImages);
-		case "pageBreak":
-		case "embeddedObject": return "";
+		case "embeddedObject":
+			if (block.objectKind === "formula" && block.document.kind === "formula" && block.document.formula.presentation !== void 0) {
+				const latex = block.document.formula.presentation.latex;
+				return latex.length === 0 ? "$$\n$$" : `$$\n${latex}\n$$`;
+			}
+			return "";
+		case "pageBreak": return "";
 	}
 }
 function listInfoFor(numId, context) {
@@ -116,16 +127,9 @@ function listInfoFor(numId, context) {
 	}
 	return info;
 }
-function checkboxPrefixFor(item) {
-	const first = item.runs[0];
-	if (first === void 0) return;
-	if (first.text.startsWith(`☒ `)) return "[x] ";
-	if (first.text.startsWith(`☐ `)) return "[ ] ";
-}
-function stripCheckboxRun(item, checkboxPrefix) {
-	if (checkboxPrefix === void 0) return item;
+function stripCheckboxRun(item) {
 	const first = item.runs[0];
-	const glyphPrefix = checkboxPrefix === "[x] " ? `☒ ` : `☐ `;
+	const glyphPrefix = first?.text.startsWith(`☒ `) ? `☒ ` : `☐ `;
 	if (!first?.text.startsWith(glyphPrefix)) return item;
 	const strippedText = first.text.slice(glyphPrefix.length);
 	const runs = strippedText.length === 0 ? item.runs.slice(1) : [{
@@ -137,8 +141,30 @@ function stripCheckboxRun(item, checkboxPrefix) {
 		runs
 	};
 }
-function renderListItemMarker(numId, info, item, context) {
-	const checkboxText = (info?.task === true ? checkboxPrefixFor(item) : void 0) ?? "";
+function firstBlockCheckbox(first, taskNumId) {
+	if (first.list?.checked !== void 0) return {
+		checkboxText: first.list.checked ? "[x] " : "[ ] ",
+		stripGlyph: false
+	};
+	if (!taskNumId) return {
+		checkboxText: "",
+		stripGlyph: false
+	};
+	const leading = first.runs[0]?.text ?? "";
+	if (leading.startsWith(`☒ `)) return {
+		checkboxText: "[x] ",
+		stripGlyph: true
+	};
+	if (leading.startsWith(`☐ `)) return {
+		checkboxText: "[ ] ",
+		stripGlyph: true
+	};
+	return {
+		checkboxText: "",
+		stripGlyph: false
+	};
+}
+function renderListItemMarker(numId, info, checkboxText, context) {
 	if (info?.type === "ordered" && numId !== void 0) {
 		const next = context.orderedCounters.get(numId) ?? info.start ?? 1;
 		context.orderedCounters.set(numId, next + 1);
@@ -160,17 +186,29 @@ function renderListRegion(items, context) {
 	while (index < items.length) {
 		const item = items[index];
 		if (item?.list === void 0) break;
-		const { numId, level } = item.list;
+		const { numId, level, itemId } = item.list;
 		const info = listInfoFor(numId, context);
-		let lookahead = index + 1;
+		let ownEnd = index + 1;
+		if (itemId !== void 0) while (ownEnd < items.length) {
+			const candidate = items[ownEnd];
+			if (candidate?.list?.level !== level || candidate.list?.itemId !== itemId) break;
+			ownEnd += 1;
+		}
+		const ownBlocks = items.slice(index, ownEnd);
+		let lookahead = ownEnd;
 		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
-		const nestedItems = items.slice(index + 1, lookahead);
-		const checkboxPrefix = info?.task === true ? checkboxPrefixFor(item) : void 0;
-		const marker = renderListItemMarker(numId, info, item, context);
-		const bodyLines = renderParagraphBody(stripCheckboxRun(item, checkboxPrefix), context).split("\n");
+		const nestedItems = items.slice(ownEnd, lookahead);
+		const first = ownBlocks[0];
+		if (first === void 0) break;
+		const { checkboxText, stripGlyph } = firstBlockCheckbox(first, info?.task === true);
+		const marker = renderListItemMarker(numId, info, checkboxText, context);
 		const indent = " ".repeat(marker.bareLength);
-		const [firstLine = "", ...restLines] = bodyLines;
+		const [firstLine = "", ...restLines] = renderParagraphBody(stripGlyph ? stripCheckboxRun(first) : first, context).split("\n");
 		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+		for (const extra of ownBlocks.slice(1)) {
+			const rendered = renderParagraphBody(extra, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+			text += `\n\n${rendered}`;
+		}
 		if (nestedItems.length > 0) {
 			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
 			text += `\n${nested}`;
@@ -232,9 +270,9 @@ function renderFootnoteDefinition(name, body) {
 	return [`${marker} ${firstLine}`, ...restLines.map((line) => line.length === 0 ? line : `${indent}${line}`)].join("\n");
 }
 function renderConstruct(item, context) {
-	const body = renderItems(item.children, context);
 	const { descriptor } = item;
 	if (descriptor.kind === "anchor" && descriptor.anchorType === "footnote") {
+		const body = renderItems(item.children, context);
 		if (isValidFootnoteLabel(descriptor.name)) return renderFootnoteDefinition(descriptor.name, body);
 		context.sink({
 			code: MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
@@ -243,6 +281,23 @@ function renderConstruct(item, context) {
 		});
 		return body;
 	}
+	if (descriptor.kind === "division") {
+		if (item.children.every((child) => {
+			if (isConstructItem(child)) return true;
+			return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
+		})) {
+			context.divisionDepth += 1;
+			const body = renderItems(item.children, context);
+			context.divisionDepth -= 1;
+			return body.split("\n").map((line) => line.length === 0 ? ">" : `> ${line}`).join("\n");
+		}
+	}
+	if (descriptor.kind === "link" && descriptor.target.kind === "external") {
+		const onlyChild = item.children.length === 1 && !isConstructItem(item.children[0]) ? item.children[0].block : void 0;
+		if (onlyChild?.kind === "image" && !isDataUri(descriptor.target.uri)) return `![${escapeMarkdownText(onlyChild.altText ?? "")}](${escapeLinkDestination(descriptor.target.uri)}${descriptor.title === void 0 ? "" : ` "${renderLinkTitle(descriptor.title)}"`})`;
+		if (onlyChild?.kind === "image" && isDataUri(descriptor.target.uri) && !context.embedImages) return emitImage(onlyChild, false);
+	}
+	const body = renderItems(item.children, context);
 	const detail = descriptor.kind === "anchor" ? `${descriptor.kind} (${descriptor.anchorType})` : descriptor.kind;
 	context.sink({
 		code: MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
@@ -283,8 +338,18 @@ function renderItems(items, context) {
 function emitBlocks(blocks, context) {
 	const imbalance = findConstructMarkerImbalance(blocks);
 	if (imbalance !== void 0) throw new MarkdownUnbalancedConstructMarkersError(imbalance.kind, imbalance.index);
+	validateRunConstructExtents(blocks);
 	return renderItems(groupConstructItems(blocks, 0).items, context);
 }
+function validateRunConstructExtents(blocks) {
+	for (const block of blocks) {
+		if (block.kind === "paragraph" && block.constructs !== void 0) {
+			const fault = findRunConstructFault(block);
+			if (fault !== void 0) throw new MarkdownInvalidRunConstructExtentError(fault.kind, fault.index);
+		}
+		if (block.kind === "table") for (const row of block.rows) for (const cell of row.cells) validateRunConstructExtents(cell.blocks);
+	}
+}
 function emitMarkdown(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new MarkdownUnsupportedDocumentKindError(document.kind);
 	const context = {
@@ -298,7 +363,8 @@ function emitMarkdown(document, options = {}) {
 		embedImages: options.images ?? true,
 		orderedCounters: /* @__PURE__ */ new Map(),
 		reportedFallbackNumIds: /* @__PURE__ */ new Set(),
-		reportedAbsentNumIdFallback: false
+		reportedAbsentNumIdFallback: false,
+		divisionDepth: 0
 	};
 	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
 	const frontMatter = options.frontMatter === true ? emitFrontMatter(document.metadata) : void 0;

package/dist/emit/inline.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_diagnostics_diagnostics = require("../diagnostics/diagnostics.cjs");
-const require_html_html = require("../html/html.cjs");
 require("../shared/style-constants.cjs");
 //#region src/emit/inline.ts
 const ESCAPE_CHARS = /* @__PURE__ */ new Set([
@@ -40,14 +39,6 @@ function escapeMarkdownText(text) {
 	let index = 0;
 	while (index < text.length) {
 		const char = text.charAt(index);
-		if (char === "<") {
-			const tag = require_html_html.matchHtmlTag(text, index);
-			if (tag !== void 0) {
-				out += tag;
-				index += tag.length;
-				continue;
-			}
-		}
 		if (char === "\n") {
 			out += "\\\n";
 			index += 1;
@@ -77,6 +68,7 @@ function renderCodeSpan(text) {
 	return risksFenceCollision || wouldBeStrippedOnReparse ? `${fence} ${text} ${fence}` : `${fence}${text}${fence}`;
 }
 function renderLeaf(run, context) {
+	if (run.source?.format === "markdown") return run.source.xml;
 	if (run.fontFamily === "Courier New") {
 		context.sink({
 			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CODE_SPAN_AS_MONOSPACE_RUN,
@@ -143,7 +135,20 @@ function escapeLinkDestination(destination) {
 	if (!/[\s()]/.test(destination)) return destination;
 	return `<${destination.replace(/[<>]/g, (char) => `\\${char}`)}>`;
 }
-function emitRuns(runs, context) {
+function renderLinkTitle(title) {
+	return title.replace(/[\n\r]+/g, " ").replace(/["\\]/g, (char) => `\\${char}`);
+}
+function linkTitleCovering(constructs, start, end) {
+	let tightest;
+	for (const extent of constructs ?? []) {
+		if (extent.descriptor.kind !== "link" || extent.descriptor.title === void 0) continue;
+		if (extent.startRun > start || extent.endRun < end) continue;
+		const current = tightest;
+		if (current === void 0 || extent.startRun > current.startRun || extent.startRun === current.startRun && extent.endRun < current.endRun) tightest = extent;
+	}
+	return tightest?.descriptor.kind === "link" ? tightest.descriptor.title : void 0;
+}
+function emitRuns(runs, context, constructs = void 0) {
 	let out = "";
 	let index = 0;
 	while (index < runs.length) {
@@ -165,19 +170,22 @@ function emitRuns(runs, context) {
 			severity: "info",
 			message: `${String(group.length)} adjacent runs share the hyperlink "${hyperlink}"; markdown has no way to place two link boundaries back to back, so they render as one link spanning their combined text`
 		});
-		if (group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
+		const title = linkTitleCovering(constructs, index, groupEnd);
+		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
 		else {
 			const linkText = renderNestedStyles(group, 0, context);
-			out += `[${linkText}](${escapeLinkDestination(hyperlink)})`;
+			out += `[${linkText}](${escapeLinkDestination(hyperlink)}${title === void 0 ? "" : ` "${renderLinkTitle(title)}"`})`;
 		}
 		index = groupEnd;
 	}
 	return out;
 }
-function emitRunsSingleLine(runs, context) {
-	return emitRuns(runs, context).replace(/\\\n/g, " ");
+function emitRunsSingleLine(runs, context, constructs = void 0) {
+	return emitRuns(runs, context, constructs).replace(/\\\n/g, " ");
 }
 //#endregion
 exports.emitRuns = emitRuns;
 exports.emitRunsSingleLine = emitRunsSingleLine;
+exports.escapeLinkDestination = escapeLinkDestination;
 exports.escapeMarkdownText = escapeMarkdownText;
+exports.renderLinkTitle = renderLinkTitle;

package/dist/emit/inline.d.cts

@@ -1,12 +1,14 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
-import { ContentRun } from "document-schema.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {
   readonly sink: MarkdownDiagnosticSink;
   readonly emphasisMarker: string;
 }
 declare function escapeMarkdownText(text: string): string;
-declare function emitRuns(runs: readonly ContentRun[], context: InlineEmitContext): string;
-declare function emitRunsSingleLine(runs: readonly ContentRun[], context: InlineEmitContext): string;
+declare function escapeLinkDestination(destination: string): string;
+declare function renderLinkTitle(title: string): string;
+declare function emitRuns(runs: readonly ContentRun[], context: InlineEmitContext, constructs?: readonly RunConstructExtent[] | undefined): string;
+declare function emitRunsSingleLine(runs: readonly ContentRun[], context: InlineEmitContext, constructs?: readonly RunConstructExtent[] | undefined): string;
 //#endregion
-export { InlineEmitContext, emitRuns, emitRunsSingleLine, escapeMarkdownText };
+export { InlineEmitContext, emitRuns, emitRunsSingleLine, escapeLinkDestination, escapeMarkdownText, renderLinkTitle };

package/dist/emit/inline.d.ts

@@ -1,12 +1,14 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
-import { ContentRun } from "document-schema.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
+import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {
   readonly sink: MarkdownDiagnosticSink;
   readonly emphasisMarker: string;
 }
 declare function escapeMarkdownText(text: string): string;
-declare function emitRuns(runs: readonly ContentRun[], context: InlineEmitContext): string;
-declare function emitRunsSingleLine(runs: readonly ContentRun[], context: InlineEmitContext): string;
+declare function escapeLinkDestination(destination: string): string;
+declare function renderLinkTitle(title: string): string;
+declare function emitRuns(runs: readonly ContentRun[], context: InlineEmitContext, constructs?: readonly RunConstructExtent[] | undefined): string;
+declare function emitRunsSingleLine(runs: readonly ContentRun[], context: InlineEmitContext, constructs?: readonly RunConstructExtent[] | undefined): string;
 //#endregion
-export { InlineEmitContext, emitRuns, emitRunsSingleLine, escapeMarkdownText };
+export { InlineEmitContext, emitRuns, emitRunsSingleLine, escapeLinkDestination, escapeMarkdownText, renderLinkTitle };

package/dist/emit/inline.js

@@ -1,5 +1,4 @@
 import { MarkdownDiagnosticCodes } from "../diagnostics/diagnostics.js";
-import { matchHtmlTag } from "../html/html.js";
 import "../shared/style-constants.js";
 //#region src/emit/inline.ts
 const ESCAPE_CHARS = /* @__PURE__ */ new Set([
@@ -39,14 +38,6 @@ function escapeMarkdownText(text) {
 	let index = 0;
 	while (index < text.length) {
 		const char = text.charAt(index);
-		if (char === "<") {
-			const tag = matchHtmlTag(text, index);
-			if (tag !== void 0) {
-				out += tag;
-				index += tag.length;
-				continue;
-			}
-		}
 		if (char === "\n") {
 			out += "\\\n";
 			index += 1;
@@ -76,6 +67,7 @@ function renderCodeSpan(text) {
 	return risksFenceCollision || wouldBeStrippedOnReparse ? `${fence} ${text} ${fence}` : `${fence}${text}${fence}`;
 }
 function renderLeaf(run, context) {
+	if (run.source?.format === "markdown") return run.source.xml;
 	if (run.fontFamily === "Courier New") {
 		context.sink({
 			code: MarkdownDiagnosticCodes.CODE_SPAN_AS_MONOSPACE_RUN,
@@ -142,7 +134,20 @@ function escapeLinkDestination(destination) {
 	if (!/[\s()]/.test(destination)) return destination;
 	return `<${destination.replace(/[<>]/g, (char) => `\\${char}`)}>`;
 }
-function emitRuns(runs, context) {
+function renderLinkTitle(title) {
+	return title.replace(/[\n\r]+/g, " ").replace(/["\\]/g, (char) => `\\${char}`);
+}
+function linkTitleCovering(constructs, start, end) {
+	let tightest;
+	for (const extent of constructs ?? []) {
+		if (extent.descriptor.kind !== "link" || extent.descriptor.title === void 0) continue;
+		if (extent.startRun > start || extent.endRun < end) continue;
+		const current = tightest;
+		if (current === void 0 || extent.startRun > current.startRun || extent.startRun === current.startRun && extent.endRun < current.endRun) tightest = extent;
+	}
+	return tightest?.descriptor.kind === "link" ? tightest.descriptor.title : void 0;
+}
+function emitRuns(runs, context, constructs = void 0) {
 	let out = "";
 	let index = 0;
 	while (index < runs.length) {
@@ -164,17 +169,18 @@ function emitRuns(runs, context) {
 			severity: "info",
 			message: `${String(group.length)} adjacent runs share the hyperlink "${hyperlink}"; markdown has no way to place two link boundaries back to back, so they render as one link spanning their combined text`
 		});
-		if (group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
+		const title = linkTitleCovering(constructs, index, groupEnd);
+		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
 		else {
 			const linkText = renderNestedStyles(group, 0, context);
-			out += `[${linkText}](${escapeLinkDestination(hyperlink)})`;
+			out += `[${linkText}](${escapeLinkDestination(hyperlink)}${title === void 0 ? "" : ` "${renderLinkTitle(title)}"`})`;
 		}
 		index = groupEnd;
 	}
 	return out;
 }
-function emitRunsSingleLine(runs, context) {
-	return emitRuns(runs, context).replace(/\\\n/g, " ");
+function emitRunsSingleLine(runs, context, constructs = void 0) {
+	return emitRuns(runs, context, constructs).replace(/\\\n/g, " ");
 }
 //#endregion
-export { emitRuns, emitRunsSingleLine, escapeMarkdownText };
+export { emitRuns, emitRunsSingleLine, escapeLinkDestination, escapeMarkdownText, renderLinkTitle };

package/dist/emit/table.cjs

@@ -54,7 +54,7 @@ function renderCellText(cell, context) {
 			});
 			continue;
 		}
-		const text = require_emit_inline.emitRunsSingleLine(block.runs, context);
+		const text = require_emit_inline.emitRunsSingleLine(block.runs, context, block.constructs);
 		if (text.length > 0) parts.push(text);
 	}
 	return escapeUnescapedPipes(parts.join(" "));

package/dist/emit/table.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
 import { InlineEmitContext } from "./inline.cjs";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/emit/table.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
 import { InlineEmitContext } from "./inline.js";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts