Quarkdown Files

Added

Page background color

.pageformat now accepts a background parameter to set the background color of each page:

:::markdown
.pageformat background:{orange}

In paged documents, the background can be scoped to specific pages, as usual:

:::markdown
.pageformat pages:{1..3} background:{orange}

Thanks @gggeon96!

Changed

Changed .extend behavior (breaking change)

.extend, introduced in v2.2.0 as experimental, has undergone a shift in behavior. This is going to play a major role in the next v2.4.0 release.

super now exposes the original function, rather than its precomputed output, and no longer needs to be declared as a parameter.

Because .super is the original function itself, it accepts the same arguments: anything you pass overrides the corresponding argument the wrapper was called with, while anything you leave out falls through unchanged. This lets the wrapper invoke the original with adjusted inputs.

:::markdown
.function {greet}
    greeting name:
    .greeting, .name!

.extend {greet}
    name greeting:
    .super greeting:{.greeting::uppercase}

.greet {Hello} {world}

Output:

:::markdown
HELLO, world

Faster live preview

Live preview now references third-party libraries through symbolic links instead of copying them (although already checksum-optimized). Preview rebuilds are faster and use less disk space, especially in documents that include code blocks, equations, or Mermaid diagrams.

[!IMPORTANT] This feature is experimental. There's a chance it might be reverted in a future release if unstable--please report any issues you may find.

Additionally, the live preview connection between the local server and the browser now runs over Server-Sent Events (SSE) instead of WebSockets.

[!NOTE] If you experience errors after launching live preview for the first time after updating, delete the output directory and run again (or run with --clean).

Fixed

Soft line breaks in CJK languages

Soft line breaks within paragraphs (newlines in the source that are not preceded by two or more spaces or a backslash) no longer insert a space when the document language is a CJK locale (Chinese, Japanese, Korean) set via .doclang.

For example, with .doclang {zh}:

:::markdown
这是一个
中文段落

is now rendered as 这是一个中文段落 instead of 这是一个 中文段落.

In all other languages, soft line breaks continue to render as a single space, following the CommonMark specification.

Thanks @CarmJos!

Orphan headings at the bottom of a page

In paged documents, a heading that would otherwise land as the last line of a page is now pushed to the top of the next page, keeping it close to the content it introduces.

.container's foreground color not applied to headings

.container foreground:{color} now correctly applies to headings.

[Security] Native content injection via string manipulation

Fixed an issue that allowed string->string functions to let unsanitized HTML through, even when the native-content permission was not granted.

.extend on functions with injected parameters

The .extend function now maps parameters correctly when wrapping native functions that feature @Injected parameters, such as document metadata functions.

[LSP] Concurrency issue in document state

Document state and request dispatching now run through thread-safe primitives, ensuring consistent behavior even under heavy load.

---

Sponsors

Thanks to our sponsors! 🎉

@vitto4

@aaditkamat