Skip to content

q2 v0.17.0

Choose a tag to compare

@github-actions github-actions released this 11 Aug 14:30
· 151 commits to main since this release
001cb6a

Experimental. q2 is under active development and not ready for production use.

Install

curl -fsSL https://raw.githubusercontent.com/quarto-dev/q2/main/install.sh | bash

On Windows (PowerShell):

irm https://raw.githubusercontent.com/quarto-dev/q2/main/install.ps1 | iex

q2 mcp (the Quarto Hub MCP server) needs Node.js 24+ at runtime;
everything else works standalone. Hub connection defaults for quarto-hub.com are built in.

The Linux binaries are statically linked (musl): one build per architecture, no glibc
requirement, works on Alpine and old distros alike. If you specifically need a
dynamically-linked build, install.sh --from-source builds one.

Platform File
Linux x86_64 (static, any distro) q2-0.17.0-linux_amd64.tar.gz
Linux ARM64 (static, any distro) q2-0.17.0-linux_arm64.tar.gz
macOS Intel q2-0.17.0-darwin_amd64.tar.gz
macOS Apple Silicon q2-0.17.0-darwin_arm64.tar.gz
Windows x86_64 q2-0.17.0-windows_amd64.zip

Verify a manual download (Unix archives are signed with minisign, Ed25519):

minisign -Vm q2-0.17.0-<platform>.tar.gz -P RWR2A9ILpZX1kVF3Q6uk5TRus8FDM25H2F+KKKHEuqlxv+JJSLyPalvN

The trusted comment should name exactly the file you downloaded.
Checksums (all platforms): sha256sum -c checksums.sha256 --ignore-missing

Standalone Quarto Hub MCP server

q2 mcp is also published on its own as a self-contained Node bundle for
running the MCP server without installing q2 — e.g. embedding it in
another tool. Requires Node.js 24+. Download
quarto-hub-mcp-0.17.0.tar.gz, extract, and run node index.mjs --help.
Unlike q2 mcp, this bundle does not embed quarto-hub.com credentials — see
the bundled README.md for the OAuth env vars to set.
(Experimental, temporary channel — npx distribution is planned.)

Changes

  • Merge pull request #500 from quarto-dev/release/v0.17.0 (001cb6a)
  • Bump workspace version to 0.17.0 for release (a5b254a)
  • Merge pull request #499 from quarto-dev/feature/bd-mermaid-cell-options-9wo3crl0 (a429bec)
  • Merge pull request #498 from quarto-dev/bugfix/include-in-code-block-f8mvtczn (0bc0b65)
  • Renumber diagram-cell diagnostics to Q-2-47/Q-2-48 after rebase (91342cf)
  • Phases 7-9: preview-parity test, docs, worked example (bd-mermaid-cell-options-9wo3crl0) (1f85d89)
  • Phase 6: source-mapped diagnostics for diagram cell options (bd-mermaid-cell-options-9wo3crl0) (653a797)
  • Phase 5: route fig-alt into mermaid's accDescr; stop dropping what we can't route (bd-il6pxq4f) (0f754c3)
  • Phase 4: unlabelled fig-cap emits Block::Figure; fig-scap sets the short caption (2aab2d4)
  • Phase 3: parse fig-cap as markdown inlines (bd-sdpp9rw4) (6e16b0a)
  • Phase 2: language-aware cell-option markers in the crossref shorthand (bd-mermaid-cell-options-9wo3crl0) (d4e7b2a)
  • Phase 1: teach cell_options that mermaid comments with %% (bd-mermaid-cell-options-9wo3crl0) (e3fd15b)
  • bd-mermaid-cell-options: record settled design decisions (df62991)
  • Investigate bd-mermaid-cell-options-9wo3crl0: mermaid %%| cell options (9142748)
  • Expand {{< include >}} inside fenced code blocks (bd-include-in-code-block-f8mvtczn) (c39cb4d)
  • Merge pull request #497 from quarto-dev/feature/bd-reference-links-unsupported-ddc4skac (def5147)
  • Record PR #497 and the Q-2-45/46 renumbering in the plan (f411c8b)
  • Warn on reference-style link syntax at render time (Q-2-45, Q-2-46) (b845232)
  • Record end-to-end verification against the real Connect docs (a7b49f9)
  • Document the reference-links and literal-brackets rules in the README (c599534)
  • Add reference-links and literal-brackets rules to qmd-syntax-helper (40e752b)
  • Record design decisions for bd-reference-links-unsupported-ddc4skac (149cc3e)
  • Investigate bd-reference-links-unsupported-ddc4skac: plan skeleton for reference-link migration rule (accc4e8)
  • Merge pull request #496 from quarto-dev/feature/bd-callout-custom-title-dropped-9qi1p7iw (d05e021)
  • bd-include-in-code-block-f8mvtczn: record design decisions D1-D7 from Q1 source + render comparison (92adde4)
  • Callout: honor the title= attribute (bd-callout-custom-title-dropped-9qi1p7iw) (dfe651c)
  • Merge pull request #495 from quarto-dev/feature/bd-email-autolink-2jj38iiv-email-autolinks (59bbccb)
  • Investigate bd-include-in-code-block-f8mvtczn: {{< include >}} inside a fenced code block (ec572c4)
  • Callout title= design: decisions + source-mapping analysis (c74402c)
  • Investigate bd-callout-custom-title-dropped-9qi1p7iw: callout title= attribute dropped (9fb8a4a)
  • Display bare address for mailto:addr autolinks (bd-email-autolink-dropped-2jj38iiv addendum) (fb2ea23)
  • Support CommonMark email autolinks: user@example.com → mailto link (bd-email-autolink-dropped-2jj38iiv) (fc95da2)
  • Investigate bd-email-autolink-dropped-2jj38iiv: bare email autolinks lexed as raw HTML (2b9f504)
  • Merge pull request #493 from quarto-dev/docs/feature-porting-process (b2b6100)
  • feature-porting process docs (bd-fu16z22k retrospective) (d1a8ac9)