pandoc-glance 0.1.0 → 0.2.0

package/README.md

@@ -42,7 +42,13 @@ pandoc-glance <file> --watch
 | `-h, --help` | Show help |
 | `-v, --version` | Show the version |
 
-Automatic format detection recognizes common Markdown extensions (`.md`, `.markdown`, `.mdown`, `.mkd`, `.qmd`, and `.rmd`) and standalone LaTeX (`.tex` and `.latex`). Use `--format` for another extension.
+Automatic format detection recognizes common Markdown extensions (`.md`, `.markdown`, `.mdown`, `.mkd`, `.qmd`, and `.rmd`) and standalone LaTeX (`.tex` and `.latex`). Use `--format` for another extension. A `.qmd` file is treated as Pandoc Markdown, with the limited document-local figure references described below; pandoc-glance does not run Quarto or reproduce project formats such as Reveal.js presentations, books, or websites. Use `quarto preview` when the Quarto build itself is the desired output.
+
+### Themes
+
+`--theme auto` is the default and follows the browser's `prefers-color-scheme` setting. `--theme light` and `--theme dark` pin the corresponding built-in palette. The palette covers the document, code highlighting, MathJax fallback, Mermaid diagrams, and preview status UI; `--font-size` controls document text separately.
+
+Themes are intentionally independent of Pi, editors, and Quarto. There is currently no custom-CSS or named-theme option.
 
 ### One-shot preview
 
@@ -71,7 +77,8 @@ pandoc-glance --watch --no-open --port 0 notes.md
 Watch mode:
 
 - Opens one browser tab and updates it after each saved change.
-- Handles ordinary writes and atomic saves.
+- Handles ordinary writes and atomic saves, collapsing save bursts to the latest pending content.
+- Skips redundant renders when the saved content has not changed.
 - Preserves reading position across reloads.
 - Keeps the last successful preview visible after a render error and recovers on the next valid save.
 
@@ -130,11 +137,38 @@ Relative paths resolve from the source document's directory:
 
 ```markdown
 ![Experiment result](figures/result.png)
+![Shared parent figure](../figures/result.png)
 ![Path containing spaces](<figures/run 01.png>)
 ![[figures/result.png|Obsidian-style caption]]
 ```
 
-Absolute local image paths are also supported. Watch mode uses revisioned, non-cached resource URLs so saved image changes appear immediately.
+PNG/JPEG/SVG-style images and local PDF figures are supported. PDF figures render their first page through pdf.js and retain an **Open PDF** link as a fallback:
+
+```markdown
+![Model diagram](../figures/model.pdf){width=80% fig-align="center"}
+```
+
+One-shot output inlines local PDF figures up to 16 MB each and 30 MB total, so the browser can render them without `file:` fetch access; larger PDFs retain the **Open PDF** fallback.
+
+Absolute paths are also supported. In watch mode, an explicitly authored parent-relative or absolute supported-media reference outside the document directory is exposed only through an opaque per-render allowlist URL; arbitrary path traversal remains blocked. Resource responses are revisioned and not browser-cached.
+
+### Figure cross-references
+
+Basic labelled-figure references support both Quarto-style identifiers and the `pandoc-crossref` convention:
+
+```markdown
+See @fig-elephant and @fig:whale.
+
+![An Elephant](figures/elephant.png){#fig-elephant}
+
+![A Whale](figures/whale.png){#fig:whale}
+```
+
+Both references become clickable **Figure N** links, and standalone captioned images receive numbered captions. Write `See @fig-elephant`, not `See Figure @fig-elephant`, because the generated link already includes “Figure”. Unlabelled standalone figures still consume a number, so later references remain consistent.
+
+This is deliberately a lightweight, document-local subset. It resolves exact single references only. Missing, duplicate, inline-image, compound, and qualified references remain visibly unresolved and produce terminal warnings. It does not implement table/equation/section references, subfigures, chapter-aware numbering, Quarto project filters, or code execution.
+
+HTML comments outside Markdown code contexts are removed before rendering, so private drafting notes do not become visible when raw HTML is disabled. Valid YAML mapping front matter and comment-like text in fenced, indented, or inline code are preserved.
 
 ### Standalone LaTeX
 
@@ -199,18 +233,22 @@ Pandoc conversion, styling, native MathML, syntax highlighting, local resources,
 - Mermaid 11.16 from jsDelivr when the document contains a Mermaid block.
 - Lucide or Logos icon data from unpkg when a diagram uses that pack.
 - MathJax 3 from jsDelivr when Pandoc leaves an equation as TeX.
+- pdf.js 4.10 from jsDelivr when the document contains a local PDF figure.
 
-Without network access, the core preview still works. Mermaid remains visible as source with an error, and unsupported equations remain as TeX with a warning.
+Without network access, the core preview still works. Mermaid remains visible as source with an error, unsupported equations remain as TeX with a warning, and PDF figures retain a direct **Open PDF** link.
 
 ## Security model
 
-Watch mode:
+One-shot pages carry a nonce-based Content Security Policy in the generated HTML. Watch mode:
 
 - Binds only to `127.0.0.1`.
 - Uses a random 192-bit token in every preview route.
+- Uses a fresh script nonce for every page response with `strict-dynamic`; inline/eval JavaScript and `javascript:` links cannot execute.
 - Sets `no-store`, `nosniff`, no-referrer, same-origin, and content-security headers.
-- Rejects path traversal, including encoded `..` and symlinks outside the source directory.
-- Serves an outside absolute file only when the current document explicitly references it, through an opaque ID.
+- Disables Pandoc raw HTML and raw attributed blocks; authored HTML is rendered inert.
+- Rejects arbitrary resource-route traversal, including encoded `..`, and rejects symlinks that escape the source directory.
+- Serves only browser-preview media types: common images, audio/video, and PDF. Source, script, HTML, and unknown file types receive `415 Unsupported Media Type`.
+- Serves a supported parent-relative or absolute media file outside the document directory only when the current document explicitly references it, through an opaque ID.
 
 A failed render keeps the previous HTML and resource allowlist.
 
@@ -247,7 +285,7 @@ The CLI uses the operating system default-browser command (`open`, `xdg-open`, o
 
 - Check the path relative to the source file, not the shell's current directory.
 - Put paths containing spaces or parentheses in Markdown angle brackets.
-- In watch mode, a relative symlink whose target is outside the document directory is deliberately blocked; use an explicit absolute path if that file should be allowlisted.
+- In watch mode, a relative symlink whose target is outside the document directory is deliberately blocked; use an explicit absolute path for a supported media file that should be allowlisted.
 - Save the image and source file. Resource responses are not browser-cached.
 
 ### The selected port is busy
@@ -277,4 +315,4 @@ Fetch the printed loopback URL, save an edit to the fixture or a temporary copy,
 
 ## License
 
-MIT. The rendering palettes and selected normalization/browser-preview patterns were adapted from the MIT-licensed [`pi-markdown-preview`](https://github.com/omaclaren/pi-markdown-preview) implementation; see [`LICENSE`](LICENSE).
+MIT. The figure-reference filter, Markdown comment scanner, rendering palettes, and selected normalization/browser-preview patterns were adapted from the MIT-licensed [`pi-markdown-preview`](https://github.com/omaclaren/pi-markdown-preview) and [`pi-studio`](https://github.com/omaclaren/pi-studio) implementations; see [`LICENSE`](LICENSE).

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { type PreviewFormatOption } from "./render.js";
 import type { PreviewTheme } from "./styles.js";
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.2.0";
 export declare const DEFAULT_FONT_SIZE_PX = 15;
 export declare const MIN_FONT_SIZE_PX = 10;
 export declare const MAX_FONT_SIZE_PX = 24;

package/dist/cli.js

@@ -8,7 +8,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { openInDefaultBrowser } from "./browser.js";
 import { assertPandocAvailable, detectFormat, renderDocument, } from "./render.js";
 import { startWatchPreview } from "./watch-preview.js";
-export const VERSION = "0.1.0";
+export const VERSION = "0.2.0";
 export const DEFAULT_FONT_SIZE_PX = 15;
 export const MIN_FONT_SIZE_PX = 10;
 export const MAX_FONT_SIZE_PX = 24;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_FONT_SIZE_PX, MAX_FONT_SIZE_PX, MIN_FONT_SIZE_PX, VERSION, CliArgumentError, helpText, parseCliArgs, runCli, type CliOptions, } from "./cli.js";
 export { openInDefaultBrowser } from "./browser.js";
-export { PandocError, assertPandocAvailable, buildInitialErrorHtml, buildPreviewHtml, detectFormat, normalizeMarkdownFencedBlocks, normalizeMathDelimiters, normalizeObsidianImages, prepareMarkdownForPandoc, renderDocument, renderPandocFragment, type BuildHtmlOptions, type LiveReloadConfig, type PreviewFormat, type PreviewFormatOption, type RenderDocumentOptions, type RenderDocumentResult, type ServerResourceConfig, } from "./render.js";
+export { PandocError, assertPandocAvailable, buildInitialErrorHtml, buildPreviewHtml, detectFormat, normalizeMarkdownFencedBlocks, normalizeMathDelimiters, normalizeObsidianImages, prepareMarkdownForPandoc, renderDocument, renderPandocFragment, stripMarkdownHtmlComments, type BuildHtmlOptions, type LiveReloadConfig, type PreviewFormat, type PreviewFormatOption, type RenderDocumentOptions, type RenderDocumentResult, type ServerResourceConfig, } from "./render.js";
 export { PreviewServer, ResourceAccessError, resolveSafeResourcePath, type PreviewServerOptions, type PreviewServerPaths, type PreviewServerState, } from "./server.js";
 export { DARK_PALETTE, LIGHT_PALETTE, buildPreviewCss, type PreviewPalette, type PreviewTheme, } from "./styles.js";
 export { WatchPreviewSession, startWatchPreview, type StartWatchPreviewOptions, type WatchPreviewStatus, type WatchRenderContext, type WatchRenderer, type WatchRenderResult, } from "./watch-preview.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export { DEFAULT_FONT_SIZE_PX, MAX_FONT_SIZE_PX, MIN_FONT_SIZE_PX, VERSION, CliArgumentError, helpText, parseCliArgs, runCli, } from "./cli.js";
 export { openInDefaultBrowser } from "./browser.js";
-export { PandocError, assertPandocAvailable, buildInitialErrorHtml, buildPreviewHtml, detectFormat, normalizeMarkdownFencedBlocks, normalizeMathDelimiters, normalizeObsidianImages, prepareMarkdownForPandoc, renderDocument, renderPandocFragment, } from "./render.js";
+export { PandocError, assertPandocAvailable, buildInitialErrorHtml, buildPreviewHtml, detectFormat, normalizeMarkdownFencedBlocks, normalizeMathDelimiters, normalizeObsidianImages, prepareMarkdownForPandoc, renderDocument, renderPandocFragment, stripMarkdownHtmlComments, } from "./render.js";
 export { PreviewServer, ResourceAccessError, resolveSafeResourcePath, } from "./server.js";
 export { DARK_PALETTE, LIGHT_PALETTE, buildPreviewCss, } from "./styles.js";
 export { WatchPreviewSession, startWatchPreview, } from "./watch-preview.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,MAAM,GAEP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,GAQrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,GAIxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,GAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAoC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,MAAM,GAEP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,yBAAyB,GAQ1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,GAIxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,GAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAoC,MAAM,cAAc,CAAC"}

package/dist/markdown-comments.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Remove Markdown HTML comments while preserving comment-like text in fenced,
+ * indented, and inline code. Micromark supplies code/escape ranges; a second
+ * tag-masked pass handles Pandoc's Markdown-inside-native-HTML behavior.
+ */
+export declare function stripMarkdownHtmlComments(markdown: string): string;
+/** Preserve valid YAML mapping front matter byte-for-byte while removing body comments. */
+export declare function stripMarkdownHtmlCommentsPreservingYamlFrontMatter(markdown: string): string;
+//# sourceMappingURL=markdown-comments.d.ts.map

package/dist/markdown-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-comments.d.ts","sourceRoot":"","sources":["../src/markdown-comments.ts"],"names":[],"mappings":"AAmPA;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAalE;AAcD,2FAA2F;AAC3F,wBAAgB,kDAAkD,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK3F"}

package/dist/markdown-comments.js

@@ -0,0 +1,277 @@
+// Adapted from pi-markdown-preview's MIT-licensed comment scanner (commit 146c022).
+import { parse, postprocess, preprocess } from "micromark";
+import { isMap, parseDocument } from "yaml";
+const PROTECTED_MARKDOWN_TOKEN_TYPES = new Set([
+    "characterEscape",
+    "codeFenced",
+    "codeIndented",
+    "codeText",
+    "definitionDestinationString",
+    "definitionTitleString",
+    "resourceDestinationString",
+    "resourceTitleString",
+]);
+function mergeRanges(ranges) {
+    const sorted = ranges
+        .filter((range) => range.end > range.start)
+        .sort((left, right) => left.start - right.start || left.end - right.end);
+    const merged = [];
+    for (const range of sorted) {
+        const previous = merged.at(-1);
+        if (!previous || range.start > previous.end) {
+            merged.push({ ...range });
+        }
+        else {
+            previous.end = Math.max(previous.end, range.end);
+        }
+    }
+    return merged;
+}
+function collectProtectedMarkdownRanges(source) {
+    const hasByteOrderMark = source.startsWith("\uFEFF");
+    const tokenizerSource = hasByteOrderMark ? source.slice(1) : source;
+    const offsetAdjustment = hasByteOrderMark ? 1 : 0;
+    const events = postprocess(parse().document().write(preprocess()(tokenizerSource, "utf8", true)));
+    const ranges = [];
+    for (const [eventType, token] of events) {
+        if (eventType !== "enter" || !PROTECTED_MARKDOWN_TOKEN_TYPES.has(token.type))
+            continue;
+        ranges.push({
+            start: token.start.offset + offsetAdjustment,
+            end: token.end.offset + offsetAdjustment,
+        });
+    }
+    return ranges;
+}
+function hasEscapedOpeningAngleBracket(source, start) {
+    let precedingBackslashes = 0;
+    for (let index = start - 1; index >= 0 && source[index] === "\\"; index -= 1)
+        precedingBackslashes += 1;
+    return precedingBackslashes % 2 === 1;
+}
+function isHtmlWhitespace(character) {
+    return character === " " || character === "\t" || character === "\r" || character === "\n" || character === "\f";
+}
+function isHtmlAttributeNameCharacter(character) {
+    return Boolean(character) && !isHtmlWhitespace(character) && !/["'=<>`/]/.test(character);
+}
+function isHtmlUnquotedAttributeValueCharacter(character) {
+    return Boolean(character) && !isHtmlWhitespace(character) && !/["'`=<>]/.test(character);
+}
+function readHtmlTag(source, start) {
+    if (source.startsWith("<!--", start) || hasEscapedOpeningAngleBracket(source, start))
+        return undefined;
+    let index = start + 1;
+    let closing = false;
+    if (source[index] === "/") {
+        closing = true;
+        index += 1;
+    }
+    if (!/[a-zA-Z]/.test(source[index] ?? ""))
+        return undefined;
+    const nameStart = index;
+    index += 1;
+    while (/[a-zA-Z0-9:-]/.test(source[index] ?? ""))
+        index += 1;
+    const tagName = source.slice(nameStart, index).toLowerCase();
+    if (closing) {
+        while (isHtmlWhitespace(source[index]))
+            index += 1;
+        return source[index] === ">" ? { end: index + 1, tagName } : undefined;
+    }
+    for (;;) {
+        while (isHtmlWhitespace(source[index]))
+            index += 1;
+        if (source[index] === ">")
+            return { end: index + 1, tagName };
+        if (source[index] === "/" && source[index + 1] === ">")
+            return { end: index + 2, tagName };
+        if (!isHtmlAttributeNameCharacter(source[index]))
+            return undefined;
+        while (isHtmlAttributeNameCharacter(source[index]))
+            index += 1;
+        while (isHtmlWhitespace(source[index]))
+            index += 1;
+        if (source[index] !== "=")
+            continue;
+        index += 1;
+        while (isHtmlWhitespace(source[index]))
+            index += 1;
+        const quote = source[index] === "\"" || source[index] === "'" ? source[index] : undefined;
+        if (quote) {
+            index += 1;
+            while (index < source.length && source[index] !== quote)
+                index += 1;
+            if (source[index] !== quote)
+                return undefined;
+            index += 1;
+            continue;
+        }
+        if (!isHtmlUnquotedAttributeValueCharacter(source[index]))
+            return undefined;
+        while (isHtmlUnquotedAttributeValueCharacter(source[index]))
+            index += 1;
+    }
+}
+function collectHtmlTags(source) {
+    const tags = [];
+    let index = 0;
+    while (index < source.length) {
+        const start = source.indexOf("<", index);
+        if (start < 0)
+            break;
+        const tag = readHtmlTag(source, start);
+        if (!tag) {
+            index = start + 1;
+            continue;
+        }
+        tags.push({ ...tag, start });
+        index = tag.end;
+    }
+    return tags;
+}
+function isMarkdownContainerPrefixOnly(value) {
+    let remainder = value;
+    for (;;) {
+        const blockQuote = remainder.match(/^[ \t]{0,3}>[ \t]?/);
+        if (blockQuote) {
+            remainder = remainder.slice(blockQuote[0].length);
+            continue;
+        }
+        const listItem = remainder.match(/^[ \t]{0,3}(?:[-+*]|\d{1,9}[.)])[ \t]+/);
+        if (listItem) {
+            remainder = remainder.slice(listItem[0].length);
+            continue;
+        }
+        return remainder.trim().length === 0;
+    }
+}
+function collectBlankDivTagStarts(source, tags) {
+    const blankTagStarts = new Set();
+    let tagIndex = 0;
+    let lineStart = 0;
+    while (lineStart <= source.length && tagIndex < tags.length) {
+        const newlineIndex = source.indexOf("\n", lineStart);
+        const lineEnd = newlineIndex < 0 ? source.length : newlineIndex;
+        while (tagIndex < tags.length && tags[tagIndex].end <= lineStart)
+            tagIndex += 1;
+        let lineTagEnd = tagIndex;
+        while (lineTagEnd < tags.length && tags[lineTagEnd].start < lineEnd)
+            lineTagEnd += 1;
+        const lineTags = tags.slice(tagIndex, lineTagEnd);
+        if (lineTags.length > 0
+            && lineTags.every((tag) => tag.tagName === "div" && tag.start >= lineStart && tag.end <= lineEnd)) {
+            let residual = "";
+            let cursor = lineStart;
+            for (const tag of lineTags) {
+                residual += source.slice(cursor, tag.start);
+                cursor = tag.end;
+            }
+            residual += source.slice(cursor, lineEnd);
+            if (isMarkdownContainerPrefixOnly(residual)) {
+                for (const tag of lineTags)
+                    blankTagStarts.add(tag.start);
+            }
+        }
+        if (newlineIndex < 0)
+            break;
+        lineStart = newlineIndex + 1;
+    }
+    return blankTagStarts;
+}
+function maskHtmlTags(source) {
+    const tags = collectHtmlTags(source);
+    if (tags.length === 0)
+        return source;
+    const blankDivTagStarts = collectBlankDivTagStarts(source, tags);
+    const pieces = [];
+    let cursor = 0;
+    for (const tag of tags) {
+        pieces.push(source.slice(cursor, tag.start));
+        const maskCharacter = blankDivTagStarts.has(tag.start) ? " " : "x";
+        pieces.push(source.slice(tag.start, tag.end).replace(/[^\r\n]/g, maskCharacter));
+        cursor = tag.end;
+    }
+    pieces.push(source.slice(cursor));
+    return pieces.join("");
+}
+function findContainingRange(ranges, offset, startIndex = 0) {
+    for (let index = startIndex; index < ranges.length; index += 1) {
+        const range = ranges[index];
+        if (offset < range.start)
+            return { range: undefined, nextIndex: index };
+        if (offset < range.end)
+            return { range, nextIndex: index };
+    }
+    return { range: undefined, nextIndex: ranges.length };
+}
+function collectMarkdownHtmlCommentRanges(source) {
+    const maskedSource = maskHtmlTags(source);
+    const protectedRanges = mergeRanges([
+        ...collectProtectedMarkdownRanges(source),
+        ...collectProtectedMarkdownRanges(maskedSource),
+    ]);
+    const commentRanges = [];
+    let protectedRangeIndex = 0;
+    let index = 0;
+    while (index < source.length) {
+        const start = source.indexOf("<!--", index);
+        if (start < 0)
+            break;
+        const protectedContaining = findContainingRange(protectedRanges, start, protectedRangeIndex);
+        protectedRangeIndex = protectedContaining.nextIndex;
+        if (protectedContaining.range) {
+            index = Math.max(start + 4, protectedContaining.range.end);
+            continue;
+        }
+        const closingIndex = source.indexOf("-->", start + 4);
+        if (closingIndex < 0)
+            break;
+        const end = closingIndex + 3;
+        commentRanges.push({ start, end });
+        index = end;
+    }
+    return commentRanges;
+}
+function blankCommentTextPreservingLineEndings(comment) {
+    return comment.replace(/[^\r\n]/g, "");
+}
+/**
+ * Remove Markdown HTML comments while preserving comment-like text in fenced,
+ * indented, and inline code. Micromark supplies code/escape ranges; a second
+ * tag-masked pass handles Pandoc's Markdown-inside-native-HTML behavior.
+ */
+export function stripMarkdownHtmlComments(markdown) {
+    const source = String(markdown ?? "");
+    const ranges = collectMarkdownHtmlCommentRanges(source);
+    if (ranges.length === 0)
+        return source;
+    let output = "";
+    let cursor = 0;
+    for (const { start, end } of ranges) {
+        output += source.slice(cursor, start);
+        output += blankCommentTextPreservingLineEndings(source.slice(start, end));
+        cursor = end;
+    }
+    return output + source.slice(cursor);
+}
+function splitValidYamlFrontMatter(source) {
+    const match = source.match(/^(\uFEFF?---[ \t]*\r?\n)([\s\S]*?)^((?:---|\.\.\.)[ \t]*(?:\r?\n|$))/m);
+    if (!match || match.index !== 0)
+        return undefined;
+    const yamlSource = match[2] ?? "";
+    const document = parseDocument(yamlSource, { prettyErrors: false, uniqueKeys: false });
+    if (document.errors.length > 0 || !isMap(document.contents))
+        return undefined;
+    const frontMatter = match[0];
+    return { frontMatter, body: source.slice(frontMatter.length) };
+}
+/** Preserve valid YAML mapping front matter byte-for-byte while removing body comments. */
+export function stripMarkdownHtmlCommentsPreservingYamlFrontMatter(markdown) {
+    const source = String(markdown ?? "");
+    const split = splitValidYamlFrontMatter(source);
+    if (!split)
+        return stripMarkdownHtmlComments(source);
+    return `${split.frontMatter}${stripMarkdownHtmlComments(split.body)}`;
+}
+//# sourceMappingURL=markdown-comments.js.map

package/dist/markdown-comments.js.map

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

package/dist/render.d.ts

@@ -44,6 +44,8 @@ export declare function detectFormat(filePath: string, requested: PreviewFormatO
 export declare function assertPandocAvailable(): Promise<void>;
 export declare function normalizeMathDelimiters(markdown: string): string;
 export declare function normalizeObsidianImages(markdown: string): string;
+/** Remove authored HTML comments without exposing their Markdown contents through Pandoc's raw-HTML boundary. */
+export declare function stripMarkdownHtmlComments(markdown: string): string;
 export declare function normalizeMarkdownFencedBlocks(markdown: string): string;
 export declare function prepareMarkdownForPandoc(markdown: string): string;
 export declare function renderPandocFragment(source: string, format: PreviewFormat, resourceRoot: string): Promise<{

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAYD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,aAAa,CAW5F;AAkGD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AA6BD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuChE;AAWD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQhE;AAWD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwDtE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0B/C;AA6iBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAqBlE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;CAC9B,GAAG,MAAM,CAST;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0BlG"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}