v2.5.0

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.

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:

.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.

.json {config.json}::get {database}::get {host}

.foreach {.json {people.json}}
    .1::get {name} is from .1::get {address}::get {country}

---

Sponsors

Thanks to our sponsors! 🎉

@vitto4