q2 v0.17.0
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 | bashOn Windows (PowerShell):
irm https://raw.githubusercontent.com/quarto-dev/q2/main/install.ps1 | iexq2 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+JJSLyPalvNThe 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)