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.21.0-linux_amd64.tar.gz |
| Linux ARM64 (static, any distro) | q2-0.21.0-linux_arm64.tar.gz |
| macOS Intel | q2-0.21.0-darwin_amd64.tar.gz |
| macOS Apple Silicon | q2-0.21.0-darwin_arm64.tar.gz |
| Windows x86_64 | q2-0.21.0-windows_amd64.zip |
Verify a manual download (Unix archives are signed with minisign, Ed25519):
minisign -Vm q2-0.21.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.21.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 #528 from quarto-dev/release/v0.21.0 (dc3cba2)
- Bump workspace version to 0.21.0 (be65173)
- Merge pull request #526 from quarto-dev/feature/bd-toc-smart-quotes-6nro57ed-carry-inlines (aa8dbb4)
- bd-toc-smart-quotes-6nro57ed phase 5: follow-ups, plan closed out (09f656d)
- bd-toc-smart-quotes-6nro57ed phases 3-4: toc-title carries markup too (25866ab)
- bd-toc-smart-quotes-6nro57ed phases 1-2: TOC entries carry inlines (f5f1826)
- bd-toc-smart-quotes-6nro57ed phase 0: e2e TOC tests (red) (b5beb5a)
- bd-toc-smart-quotes-6nro57ed: convert plan to work-item checklist (4585a01)
- bd-toc-smart-quotes-6nro57ed: design settled, all questions answered (ca87944)
- bd-toc-smart-quotes-6nro57ed: correct the metadata-parsing premise (f651db6)
- bd-toc-smart-quotes-6nro57ed: scope settled — TOC entries carry inlines (a78b486)
- Investigate bd-toc-smart-quotes-6nro57ed: TOC entry drops quote glyphs (a455951)
- Merge pull request #525 from quarto-dev/feature/draft-alert-banner (32c75e3)
- Merge pull request #524 from quarto-dev/feature/root-relative-paths-fc5pvkcv (8e9d288)
- Merge pull request #521 from quarto-dev/bugfix/bd-sidebar-contents-dir-shorthand-z7arvhx8 (b677afd)
- Merge pull request #522 from quarto-dev/chore/strip-release-symbols (ba65f5f)
- Strip symbols from release binaries (bd-p0p4r9b2) (22e5716)
- Emit Q1's #quarto-draft-alert banner on draft pages (bd-draft-banner-missing-hgx1gkqm) (1ce09c8)
- Phase 4 (bd-root-relative-paths-design-fc5pvkcv): docs, VFS-mode image gate, follow-up strands (8bdb97c)
- Correct the tree-sitter note: stale local artifact, not a grammar issue (526a94c)
- Case C (bd-root-relative-paths-design-fc5pvkcv): markdown images + links first-class in nav/footer regions (5da1e5f)
- bd-draft-banner-missing-hgx1gkqm: settle four of five design questions (d94039c)
- Case A (bd-root-relative-paths-design-fc5pvkcv): resolve + copy the navbar logo (0b4683f)
- Investigate bd-draft-banner-missing-hgx1gkqm: draft alert banner is HTML-emission-only (3a2b2eb)
- Case B (bd-root-relative-paths-design-fc5pvkcv): rebase image targets page-relative (1d17a9c)
- bd-root-relative-paths-design-fc5pvkcv: record design decisions in plan (4e7b764)
- Investigate bd-root-relative-paths-design-fc5pvkcv: site-root-relative paths (3 cases) (ad127d0)
- Phase 6: record verification gate results (d8c55a9)
- Phase 5: document the scalar contents: shorthand in Q-13-6 (27915ca)
- Phases 2-3: contents: shorthand + expand sidebars before selecting (0a3a99f)
- Phase 1: auto: expands to a titled section (Q1 parity) (726bc59)
- Merge pull request #520 from quarto-dev/feature/bd-v9zs83zj-footnotes-appendix-heading (0dcd7e8)
- Title every appendix section, localized, and drop the footnotes rule (bd-v9zs83zj) (60d42f0)
- Investigate bd-sidebar-contents-dir-shorthand-z7arvhx8: sidebar contents: shorthand (48b12a7)
- bd-v9zs83zj: settle design, research .anchored, file follow-up (1ff7d49)
- Investigate bd-v9zs83zj: missing Footnotes appendix heading (376f78e)