← Back to home
Comparison · Infra & APIs

pkgdown vs q2

A side-by-side editorial comparison of pkgdown and q2 — release velocity, themes, recent moves, and the top alternatives to consider.

Shared themes:quarto

pkgdown vs q2: at a glance

Featurepkgdownq2
SectorInfra & APIsInfra & APIs
Velocity score0.06.3
Sparks · 30d01
Top themesdocumentation, llm-readable, quarto, dark-moderust-rewrite, publishing-toolchain, quarto, theming
Last editorial update5d ago12h ago
WebsiteVisit →Visit →

What is pkgdown?

pkgdown now generates llms.txt and a markdown copy of every documentation page

pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.

Read the full pkgdown trajectory →

What is q2?

After two releases pulling ahead, q2 spends v0.23.0 back on parity: light/dark theming.

q2 is the Quarto team's Rust reimplementation of the publishing toolchain, shipping as a statically linked single binary with minisign-signed archives and a bundled Quarto Hub MCP server, still marked experimental and not production-ready. The cadence holds at roughly a release a day through mid-August, with raw commit logs standing in for curated notes. v0.22.0 was the break in the pattern — llms.txt site output and a live-share preview, the first capability the original toolchain does not have. v0.23.0 goes straight back to closing the parity gap, and does it at epic scale.

Read the full q2 trajectory →

pkgdown vs q2: editorial side-by-side

P
pkgdown
INFRA · APIS
0.0

pkgdown now generates llms.txt and a markdown copy of every documentation page

◆ Current state

pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.

◆ Where it's heading

Two audiences are now being served from one build. Human-facing work continues in small increments - dark-mode plot filtering, new translations, a local http server so search works in preview - while the new machine-facing output is opt-out rather than opt-in. The default matters more than the feature: thousands of package sites will start emitting llms.txt without their maintainers choosing to.

◆ Prediction

Expect the markdown output to gain the same configuration surface the HTML has, and the llms.txt contents to get more selective as maintainers discover what ends up in it; a way to exclude individual pages is the obvious next request.

Q
q2
INFRA · APIS
6.3

After two releases pulling ahead, q2 spends v0.23.0 back on parity: light/dark theming.

◆ Current state

q2 is the Quarto team's Rust reimplementation of the publishing toolchain, shipping as a statically linked single binary with minisign-signed archives and a bundled Quarto Hub MCP server, still marked experimental and not production-ready. The cadence holds at roughly a release a day through mid-August, with raw commit logs standing in for curated notes. v0.22.0 was the break in the pattern — llms.txt site output and a live-share preview, the first capability the original toolchain does not have. v0.23.0 goes straight back to closing the parity gap, and does it at epic scale.

◆ Where it's heading

The light-dark epic is the shape of how this team retires a Quarto 1 feature: a design doc, then ThemeConfig growing a parsed dark variant, dual theme compilation with color-scheme emission, attributed stylesheet links, a color-mode toggle runtime, an accessibility-aware highlight-style reader, a brand light/dark seam, and an end-to-end verification pass against quarto-web before the docs land. One phase (D) was deferred with its options recorded rather than dropped. Around it, panel-tabset support lands, format.html.css is finally copied and rebased per page, and the llms companion output gains a link-format attribute so authors control where companion links point — the one thread tying this release back to the v0.22.0 work.

◆ Prediction

Expect the remaining Q1 parity items to keep setting the release agenda, with the deferred light-dark phase D and the freshly opened panel-tabset plan the two named strands most likely to fill the next few tags. npx distribution for the standalone Quarto Hub MCP bundle is still the only distribution item the notes explicitly call planned.

Alternatives to pkgdown and q2

Other Infra & APIs products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either pkgdown or q2.

See all pkgdown alternatives → · See all q2 alternatives →

Recent activity from pkgdown and q2

Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.

  1. 1d agoq2Light/dark themes with a color-mode toggle; panel-tabset support
  2. 4d agoq2llms.txt site output and a live-share collaborative preview
  3. 5d agoq2TOC entries carry inline markup; draft banner restored
  4. 6d agoq2Adds alias redirect stubs and diagnostic suppression
  5. 6d agoq2Bumps samod and automerge; fixes indented continuations
  6. 7d agoq2Lua filters supported; mermaid bundled instead of CDN-loaded
  7. 1mo agopkgdownLocal preview served over http so search works
  8. 9mo agopkgdownbuild_llm_docs() emits llms.txt and markdown for every page
  9. 1y agopkgdownMenu items accept class and id attributes
  10. 1y agopkgdownROR IDs, Codeberg support, bslib navbar variables
  11. 1y agopkgdownKeyboard shortcut for search; clean_cache() added
  12. 2y agopkgdownQuarto vignettes, light/dark switch, self-hosted assets

Frequently asked questions

What is the difference between pkgdown and q2?

Both compete on the same themes — quarto — within Infra & APIs. q2 is currently shipping more aggressively (velocity 6.3 vs 0.0), with 1 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.

Is pkgdown better than q2?

Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. q2 is currently shipping more aggressively (velocity 6.3 vs 0.0), with 1 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Infra & APIs products to evaluate alongside.

What are the best alternatives to pkgdown?

Top pkgdown alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "pkgdown alternatives" section above for the current picks, or visit /alternatives/pkgdown for the full list with editorial commentary on each.

What are the best alternatives to q2?

Top q2 alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "q2 alternatives" section above for the current picks, or visit /alternatives/q2 for the full list with editorial commentary on each.