v2.7.02026-10-29
This release marks one of Quarkdown's most significant milestones towards becoming a mature, community-driven project!
Added
Packages & package manager
This release comes with Quarkdown's long-awaited package manager! You can browse the available packages in the new catalog.
A package, called atom, can be easily included into your document the same way you .include any other local Quarkdown file, with the special syntax @scope/name:version.
The officially maintained scope, @atoms, is a GitHub-hosted repository anyone can contribute to.
``markdown
.include {@atoms/cowsay:1.0.0}
.cowsay {Hello, Quarkdown!}
`
We can't wait to see your creations!
Project templates from packages
quarkdown create can now scaffold a project from a template package, via the new --template option:
quarkdown create --template @atoms/simple-cv:1.0.0
Linux-ARM support
Quarkdown now runs on Linux-aarch64!
Thanks @maximilianbarg!
Styling options on .row, .column and .grid
Stack functions now accept the same styling options as .container, such as background, foreground, border, padding, radius and the font options, along with width and height, without relying on container wrapping.
`markdown
.row gap:{1cm} width:{12cm} background:{teal} foreground:{white} padding:{12px} radius:{8px}
A
B
`
Scoped page formatting in slides
The pages and side parameters of .pageformat, previously available only in paged documents, now also work in slides documents. A scoped format applies its properties to the selected slides only.
`markdown
.pageformat pages:{2..3} background:{navy} alignment:{start}
`
Page content padding
.pageformat accepts a new padding parameter, which adds blank space inside the content area of each page, between its borders and the content.
`markdown
.pageformat padding:{1cm} bordercolor:{red}
`
Color building and derivation
The new .color function builds a color from its red, green, blue and alpha components, each optional, and a base color:
`markdown
.var {brand} {red}
.container background:{.brand::color alpha:{0.25}}
`
New boolean operations: and and or
The new and and or functions combine two boolean values, complementing the existing not.
`markdown
.if {.x::islower than:{10}::and {.x::isgreater than:{0}}}
x is between 0 and 10
`
New collection operation: contains
The new contains function checks whether a string contains some text, a collection contains an element, or a dictionary contains a key.
`markdown
.var {letters}
- A
- B
.if {.letters::contains {B}}
B is in the list
`
New collection operation: withindices
The new withindices function turns a collection into a dictionary that maps each element's position, starting at 1, to the element itself.
This makes numbered iteration straightforward.
`markdown
.var {letters}
- A
- B
.letters::withindices::foreach
index letter:
.index .letter
`
> Output:
> 1 A
> 2 B
New collection operations: findfirst and findall
The new findfirst function returns the first element of a collection that satisfies a condition, or none if there is no such element.
findall returns all of them as a new collection instead, like a filter.
`markdown
.var {numbers}
- 3
- 8
- 12
.numbers::findfirst {n: .n::isgreater than:{5}}
`
> Output: 8
New loop: join
The new join function merges the elements of a collection into a single inline content, separated by , or by a custom separator.
`markdown
.var {letters}
- A
- B
- C
.letters::join
`
> Output: A, B, C
Like foreach, it also accepts a body that transforms each element before joining.
`markdown
.letters::withindices::join
index letter:
.index .letter
`
> Output: 1 A, 2 B, 3 C
New string operation: split
The new split function breaks a string into a collection of its parts, delimited by , or by a custom separator.
`markdown
.var {date} {2026-10-24}
.date::split separator:{-}::first
`
> Output: 2026
New factory functions: emptycollection and emptydictionary
The new emptycollection and emptydictionary functions create an empty collection and an empty dictionary, respectively.
`markdown
.emptycollection::size
`
> Output: 0
Changed
Pure black text in printed paperwhite documents
The paperwhite color theme now uses pure black as its main text color in paged documents and when printing, for a crisper result on paper. On screen, other document types keep the softer black.
Sidebar stays hidden while selecting text
In the HTML view of plain and paged documents, dragging the mouse to select text across the right edge of the page no longer expands the navigation sidebar.
Fixed
Missing lines at page breaks
In paged documents, a page could lose its last lines when either:
- the last line of a page ended with a word hyphenated by the browser
- a footnote needed more room at the bottom of its page than Quarkdown had reserved for it
Page breaks no longer split words, footnotes are measured correctly, and long links in footnotes now wrap.
Custom fonts in slides
In slides documents, fonts set via .font were ignored when the layout theme defined its own fonts.
CSS styles on Android
Injecting !important into CSS rules used to raise syntax errors on Android's ICU-based Pattern.
Thanks @YoannDev90!
Stack traces when the export port is taken
When the port used to serve the document during PDF export was already in use, Quarkdown already moved on to the next free port, but printed a java.net.BindException stack trace for every occupied port it went through. The scan is now quiet on info and higher log levels.
Iterating a dictionary stored in a variable
Fixed an issue that caused a dictionary assigned to a variable, such as .var {x} {.data::dictionary}, to be rejected by functions that accept a collection, like .withindices or .foreach`.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.6.42026-10-09
Added
SI units in TeX formulas
The new built-in latex-siunitx library brings the commands of LaTeX's siunitx package to TeX formulae.
.include {latex-siunitx}
$ \qty{9.81}{\meter\per\second\squared} $
Changed
Faster paged document rendering
Paged documents now render up to 6x faster in the browser, live preview, and PDF export.
Avoid breaking page inside table rows
Table rows now avoid page breaks by in paged documents, as long as they fit on one page.
Thanks @Ethereal49!
Fixed
Documents with many block function calls compile in linear time
Tokenization of a block-level function call was optimized to be linear rather than quadratic, and more memory-efficient.
Faster loops and custom functions
Loops like .repeat and .foreach, and custom functions defined via .function, run up to four times faster when their body calls other functions.
Pre-compiled localization
Every compilation is now a few milliseconds faster, as the built-in stdlib localization table is no longer processed from scratch each time.
Positional page size
.pageformat {A4} sets the page size again, as it did before page sides and ranges were introduced.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.6.32026-10-01
Changed
Faster source tokenization
Source tokenization is now implemented via scanner rather than regex, making the first stage of compilation up to 5x faster.
Fixed
.tablebyrows accepts dynamically typed rows
Rows generated dynamically, such as the output of .repeat stored in a variable, can now be used as table rows. Previously, this failed with a type cast error.
``text
.var {rows}
.repeat {3}
index:
- - Cell .index:A
- Cell .index:B
.tablebyrows rows:{.rows}
`
CommonMark emphasis correctness
bold italic still italic* now renders correctly.
Numbered lists past nine items
A line such as 10. item now correctly starts a new item.
A decorative heading interrupts paragraphs
#! Heading now closes the preceding paragraph, like regular headings do.
A bare ### line under a heading is its own heading
A line of hashes with nothing after them used to be absorbed by the heading above it, so it disappeared.
A line of tabs separates paragraphs
A line containing only tabs now separates paragraphs, as a line containing only spaces always did.
Deeply nested link destinations
Parentheses in a link destination now balance correctly at any depth.
Multi-line setext headings keep all their lines
A heading underlined by === or --- that spans several lines used to keep only the last line. The whole text now becomes the heading.
Flat stack usage for block tokenization
Tokenization of Markdown paragraphs, lists, list items, blockquotes, tables, code, footnotes, and setext headings no longer grows the recursion stack linearly, optimizing resource usage and preventing crashes on small stacks.
REPL prints to console
Fixed a regression that caused quarkdown repl` to write to file rather than to stdout.
Preview runs no longer re-scan libraries
Preview sessions no longer look for available libraries on each run, slightly improving performance.
PDF export no longer fails when its port is busy
Fixed a regression that caused PDF export to fail instead of moving on to the next free port, if the current one was busy.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.6.22026-09-22
Fixed
Lines of trailing whitespace no longer produce empty code blocks
A line consisting of 4 or more spaces, immediately after content, is no longer tokenized as an indented code block.
Empty code blocks no longer error out on the browser
Empty code blocks used to throw a runtime error, which also caused paged documents to break.
[Security] Prevent path traversal (CWE-22)
> [!NOTE]
> The vulnerability was already unexploitable due to existing Ktor (Quarkdown's server library) security measures, and purely theoretical. This patch prevents any future regressions.
Prevented path traversal vulnerabilities that could allow attackers to access files outside the intended directory from the live preview endpoint (/live/).
Thanks to the GitLab Security team for reporting!
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.6.12026-09-18
Changed
Tables split across pages repeat their header row
In paged documents, when a table is split across two or more pages, each page now repeats the header row.
Log level via --log-level
The log level is now set through the new --log-level option (debug, info, warn, error, or none) or the QDLOGLEVEL environment variable, with the option taking precedence. The old -Dloglevel JVM property is no longer read.
``shell
quarkdown --log-level debug c main.qd
`
PDF compilation hint in quarkdown create
After creating a new project via quarkdown create, the summary now also suggests the command to compile the document to PDF.
[dev] Bibliography management delegated to kotlin-bibliographer
The Citation Style Language processor, bibliography management and style catalog were extracted and offloaded to the new kotlin-bibliographer, Quarkdown's own Kotlin Multiplatform open source library.
Fixed
Very long delimited contents no longer crash the compiler
Fixed an issue that caused very long (multi-KB) delimited content, such as emphasized text or LaTeX formulas, to crash the compiler with a stack overflow.
Code blocks near page breaks no longer lose content
In paged documents, a code block close to a page break could be rendered only partially, or not at all, because syntax highlighting was applied after page breaks were calculated.
Content taller than a page after a heading is no longer cut off
In paged documents, a code block or table taller than a full page placed right after a heading was not rendered, leaving a blank page and the heading alone. Such content now starts right below its heading and flows across as many pages as needed.
Code blocks split in place across pages
In paged documents, a code block that does not fit in the remaining space of a page now starts there and continues on the next page, instead of being pushed to a fresh page.
Caption position of elements split across pages
In paged documents, the caption of a table or code block split across two or more pages now respects its position: a top caption stays with the first portion of the element, and a bottom caption follows the last one. The caption always shares the page with part of the element's content, and is never left alone on a page.
Page size in slides
In slides documents, the page size set via .pageformat` now correctly defines the presentation's base resolution.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.6.02026-09-08
The highlights of this release include significant performance improvements, better portability thanks to reduced binary size and less external dependencies, and enhanced slides artifacts.
Added
New layout theme: focus
The new focus layout theme is an adaptation of the Focus Beamer theme. It’s a simple and clean theme well-suited for slides and articles.
Recommended combination:
``text
.theme {paperwhite} layout:{focus}
`
Code block callouts
The new callouts argument of the .code function attaches numbered markers to specific lines of a code block, each paired with a description displayed right below the block.
`markdown
.code callouts:{
- 2: Defines the horizontal coordinate.
- 5: Takes the two coordinates.
- 6: Assigns the horizontal coordinate.
}
.read {point.ts}
`
<img width="660" alt="Callout" src="https://github.com/user-attachments/assets/99521edd-4ef0-4566-b114-3027c4fb5c91" />
Slides-tailored project creation
Creating a new slides project via quarkdown create now generates starter content designed for presentations.
New collection operations: prepended and appended
The new prepended and appended functions add an element at the beginning or end of a collection, respectively, without affecting the original collection.
`markdown
.var {letters}
- B
- C
.foreach {.letters::prepended {A}::appended {D}}
.1
`
> Output:
>
> `text
> A
> B
> C
> D
> `
Changed
PDF export without Node.js [ecosystem breaking change]
Exporting to PDF no longer requires Node.js, npm, and Puppeteer. Quarkdown now communicates directly with a Chromium-family browser, which makes PDF generation significantly faster and simpler to set up.
Package manager installations download a headless Chrome shell automatically. If you installed Quarkdown manually, download it from the Chrome for Testing page, or point Quarkdown to an existing Chromium-family installation with the new --chrome-path option or the QDCHROMEPATH environment variable.
> Migration note: the --node-path and --npm-path options, along with the QDNPMPREFIX and NODE_PATH environment variables, are no longer used. quarkdown doctor env now reports the browser's status.
slides break page on H2
Unless overridden via .autopagebreak, slides documents now automatically break page on every H1 and H2.
This release aims at making H1 the standard for title slides, and H2 for content slides.
.row and .column inherit global alignment by default
When alignment isn't explicitly set, .row and .column now inherit the parent's alignment (e.g. center in centered slides) instead of defaulting to start.
Improved beamer theme
The beamer theme's layout was improved for a more consistent look.
Reflectionless function calls
Calling a native function no longer involves JVM reflection, improving performance (the official wiki now compiles 10% faster) on function-heavy documents and opening the door to future optimizations.
Optimized locale lookup
Locale resolution from .doclang was optimized, via a compile-time-generated and efficiently indexed table. Improvements include faster lookups, true platform independence, reduced memory usage, and smaller binary size.
Breaking change: calling .doclang without a parameter now returns the English name of the current locale, rather than its localized name.
Fixed
Wide tables in docs documents scroll horizontally
In docs documents, a table wider than the content area now scrolls horizontally within its own area.
slides PDF export improvements
PDF artifacts generated from slides documents now feature a more polished layout.
Blank (headerless) slides are now spaced correctly.
Block-aware .text, .codespan and .whitespace
The .text, .codespan and .whitespace functions now adapt to where they are called.
This fixes spacing issues when invoked as block-level functions.
Layout themes: bold weight and leaner font artifacts
Fixed an issue that caused bold text in minimal and beamer themes to be browser-synthesized. It is now correctly and consistently rendered.
Additionally, the two themes now ship smaller font artifacts that reduce the size of both the HTML output and the Quarkdown distribution.
Scoped function extensions
Function extensions declared in a nested scope now compose with inherited extensions only within that scope, without leaking into parent or sibling scopes.
Thanks @emerardd!
Bibliography: bare DOIs now link to doi.org
A DOI given as a plain identifier now links to its absolute https://doi.org/` address.
[LSP] Fixed incorrect parameter completions inside body arguments
When inside a body argument, the language server doesn't suggest other sibling parameters anymore.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.5.12026-08-12
Changed
[dev] Embedding-friendly pipeline error handling
The programmatic pipeline entry point runQuarkdown no longer terminates the host JVM on pipeline errors, in favor of propagation to the caller.
Fixed
Unbalanced parentheses in links
An inline link text followed immediately by a closing parenthesis no longer swallows the trailing ). Plain link destinations now require parentheses to be either backslash-escaped or balanced, matching the CommonMark spec.
Deeply nested lists with 4-space indentation
Nested lists that use 4 spaces of indentation at every level now render correctly at three or more levels.
Subdocument links missing a trailing slash
Links to subdocuments in HTML output now end with a trailing slash, to minimize 404s on hosts that do not redirect to the trailing-slash form. The <link rel="canonical"> tag, sitemap.xml, and the client-side search index now use the same form too.
[lsp] Completion crash on out-of-bounds cursor position
The language server no longer crashes when a completion request arrives with a cursor position outside the document bounds.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.5.02026-08-04
This release focuses on enhanced built-in LLM friendliness of sites produced by Quarkdown.
Quarkdown's Wiki, written in Quarkdown, now scores 94/100 on afdocs (previously 72/100), granting excellent agent readability with minimal setup.
Added
Markdown export
Quarkdown documents can now be exported to GitHub Flavored Markdown via the new --render markdown or --render gfm option, producing .md files.
``bash
quarkdown c document.qd -r markdown
`
This plays an important role in AEO optimization, as AI agents usually prefer Markdown to HTML. Multi-target compilation allows shipping sites in both formats from the same source.
See SEO & AEO optimization for more details.
The new .markdown function lets you include raw Markdown content when exporting to Markdown.
Built-in llms.txt support
llms.txt is a Markdown file at the root of a site that curates the most useful entry points for AI agents and LLM-based crawlers, giving them a reliable map of the documentation.
The new .llmstxt function generates an llms.txt at the site root, listing every subdocument as an absolute link.
Code block primitive
.code is now a primitive, so it can be intercepted via .extend {code} to customize the appearance of every code block in the document.
The following snippet hides line numbers on every JavaScript code block:
`markdown
.extend {code} where:{lang: .lang::equals {javascript}}
.super linenumbers:{no}
`
Load data from JSON files
The new .json {path} function loads a JSON file and returns its content in a shape you can query and iterate.
`markdown
.json {config.json}::get {database}::get {host}
`
`markdown
.foreach {.json {people.json}}
.1::get {name} is from .1::get {address}::get {country}
``
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.4.12026-07-26
Added
em size units
Size values now support the font-relative em unit, e.g. 2em, 0.7em.
Thanks @arpitagarwal1301!
Fixed
Inline replacement lambdas accept nested function calls
Node-returning function calls, such as .text, can now be used in .match and other body lambdas as expected.
``markdown
.match {Quarkdown takes its name from quarks} pattern:{[Qq]uark(down|s)?}
.1::text color:{purple} decoration:{underline}
`
Chained .extend composes in declaration order
Multiple extensions on the same function now stack in the correct LIFO declaration order. The following snippet now correctly renders the heading in red, rather than blue:
`markdown
.extend {heading}
.super foreground:{blue}
.extend {heading}
.super foreground:{green}
.extend {heading}
.super foreground:{red}
Heading
`
.match in chained extensions sees content correctly
Fixed the ability to chain multiple .match calls onto the same content:
`markdown
.extend {paragraph}
content:
.super
.content::match {A}
.1::text color:{blue}
.extend {paragraph}
content:
.super
.content::match {B}
.1::text color:{red}
`
Fixed empty pages on CSS declarations
Fixed an issue that caused .css and .cssproperties to produce empty pages in paged documents when the declaration was before an H1.
Thanks @arpitagarwal1301!
Backslashes allowed in all-in-one footnotes
Escape sequences and any content containing a backslash, such as math expressions, are now recognized inside the [^label: ...]` form of footnote definitions.
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>
v2.4.02026-07-13
Quarkdown 2.4 is one of the most impactful releases in the history of the project, introducing a new system for extending Markdown elements behavior and styling.
You can read in detail about this powerful feature in its blog post.
Added
Element styling (show-rules)
> [!NOTE]
> This feature is experimental.
When .extend is applied to a function of the Primitives module, its new behavior is reflected on its Markdown counterpart. For example, extending the .heading function affects the # Heading Markdown element.
This is one of the biggest milestones for Quarkdown, on par with Typst's #show rules.
``markdown
.extend {heading}
content:
.super foreground:{blue}
.content
A heading <!-- Renders blue and italic -->
`
This release ships with a handful of primitives as an experimental feature: headings, paragraphs, links, figures, images, math, page breaks. The plan is to eventually have every Markdown element type backed by a primitive function.
New primitives: .paragraph, .math, .link
The new .paragraph primitive backs Markdown paragraphs, .math backs $-delimited math blocks, and .link backs Markdown links, enabling extensions via .extend.
Full styling options on .heading, .paragraph, .math and .link
.container's styling options, such as foreground, background, border, padding, and fontsize, are now available on .heading, .paragraph, .math and .link as well. This allows for full customization without needing to wrap the element in a container.
`markdown
.heading {Introduction} depth:{1} background:{blue} radius:{8px}
`
This plays particularly well with the new primitive extension system:
`markdown
.extend {heading}
content:
.super background:{red} foreground:{white} padding:{10px}
`
Conditional .extend
.extend's new where parameter defines a condition to meet. If not met, the behavior falls back to the original function definition.
The following snippet applies a teal background to all headings of depth 1 and 2, while leaving deeper headings unchanged:
`markdown
.extend {heading} where:{depth: .depth::islower than:{3}}
.super background:{teal}
`
The following snippet adds an icon to all external links:
`markdown
.extend {link} where:{url: .url::startswith {https://quarkdown.com}::not}
content:
.super
.content .icon {box-arrow-up-right}
`
Regex match
The new .match function finds every substring of inline content that matches a regular expression and replaces each match with the inline content produced by a lambda.
`markdown
.match {Quarkdown takes its name from quarks} pattern:{[Qq]uark(down|s)?}
.1
`
Output:
> Quarkdown takes its name from quarks
This is particularly useful for element styling:
`markdown
.extend {paragraph}
content:
.super
.content::match {[Qq]uark(down|s)?}
.1
Quarkdown takes its name from quarks
`
Changed
Inline lambdas without @lambda
Inline lambdas passed as arguments no longer require the @lambda prefix. When the target parameter is a Lambda, the argument is parsed as a lambda directly.
`markdown
.num::takeif {x: .x::equals {5}}
`
`markdown
.mydictionary::sorted by:{name value: .value}
`
`markdown
.extend {heading} where:{depth: .depth::islower than:{3}}
.super background:{teal}
`
The @lambda prefix is still accepted for backward compatibility with older documents.
Body argument binding
Native functions can now explicitly designate a body parameter. Previously, the body argument of a function call always bound to the last parameter of the function.
Affected functions are .text and .heading.
This means the following now works as expected:
`markdown
.text size:{large} weight:{bold}
Inline content
`
Inline binding keeps working as before, so the following is still valid:
`markdown
.text {Inline content} size:{large} weight:{bold}
`
Optimized argument binding
Parameter lookup now performs a single pass over the arguments, improving performance.
Body arguments for inline function calls
Inline function calls now accept body arguments, just like block-level calls do.
The following is now valid:
`markdown
.heading depth:{1}
.text size:{large}
Content
`
Whereas previously, this was the only valid form:
`markdown
.heading {.text {Content} size:{large}} depth:{1}
``
*
Sponsors
Thanks to our sponsors! 🎉
@vitto4
@aaditkamat
<a href="https://falconer.com"><img src="https://raw.githubusercontent.com/iamgio/quarkdown/project-files/images/sponsors/falconer.jpeg" alt="Falconer" width="350"></a>