+ "markdown": "---\ntitle: Quarto 1.7 \ndescription: |\n Quarto 1.7 brings big improvements to dark mode along with updates to Typst, Pandoc, a new `version` shortcode, and improvements to the `julia` engine.\ncategories:\n - Quarto 1.7\n - Releases\nauthor: Charlotte Wickham\ndate: \"xx/xx/2025\"\ndraft: false\nimage: thumbnail-1.7.jpeg\nimage-alt: \"Quarto 1.7: half the Quarto logo is light on dark, the other half dark on light\"\n---\n\nQuarto 1.7 is out! You can get the current release from the [download page](/docs/download/index.qmd).\n\nWe are especially enthusiastic about the improvements 1.7 brings to dark mode: you can now specify light and dark themes via brand, map computational outputs to themes, and have your website theme follow your viewer's preference.\nTo celebrate these changes, this site, [quarto.org](/), now has a light and dark mode.\nToggle the switch in the navigation bar (`<i class=\"bi bi-toggle-off\"></i>`{=html}) to see the difference.\n\nYou can read about these improvements and some other highlights below. You can find all the changes in this version in the [Release Notes](/docs/download/changelog/1.7/).\n\n## Dark Mode Improvements\n\n### Specify light and dark themes via **brand.yml**\n\nYou can now specify a light and dark brand.\nFor example, at a project-level you can provide two brand files:\n\n```{.yaml filename=\"_quarto.yml\"}\nbrand:\n light: light-brand.yml\n dark: dark-brand.yml\n```\n\nStandalone HTML pages, websites, and dashboards will gain a light switch toggle allowing viewers to switch between the light and dark themes. \n\n::: {layout-ncol=2}\n\n{fig-alt=\"Screenshot of a webpage with a light blue body and charcoal text. A switch toggle in the navbar is 'off'.\"}\n\n{fig-alt=\"Screenshot of a webpage with a dark charcoal body and light blue text. A switch toggle in the navbar is 'on'.\"}\n\n:::\n\n\nBy default Typst documents will use the light brand, but you can set the `brand-mode` option to use the dark brand instead:\n\n```{.yaml filename=\"document.qmd\"}\n---\nformat:\n typst:\n brand-mode: dark\n---\n```\n\nRead about other ways to set a light and dark brand in [Guide > Brand](/docs/authoring/brand.qmd#dark-brand).\n\n\n### Map computational outputs to themes\n\nA new code cell option, `renderings`, allows you to indicate which computational outputs should be displayed in light and dark mode. \nCreate light and dark versions of your outputs in a single code cell, \nand add the option `renderings` to specify the order of the outputs.\nFor example, this cell creates a `light` version of a plot, \nthen a `dark` version:\n\n\n::: {.cell renderings='[\"light\",\"dark\"]'}\n\n````{.cell-code}\n```{{r}}\n#| renderings: [light, dark]\nplot(1:10) # Shown in `light` mode\n\npar(bg = \"#000000\", fg = \"#FFFFFF\", col.axis = \"#FFFFFF\")\nplot(1:10) # Shown in `dark` mode\n```\n````\n\n::: {.cell-output-display}\n{width=672}\n:::\n\n::: {.cell-output-display}\n{width=672}\n:::\n:::\n\n\nBoth outputs are produced, but you'll only see the one corresponding to the current state of the light switch.\nToggle the switch in the navigation bar to see the image change to reflect the theme.\n\n### Respect user color scheme\n\nSet the new `html` format option `respect-user-color-scheme` to `true` if you would like your site to honor the viewer’s operating system or browser preference for light or dark mode:\n\n```{.yaml filename=\"_quarto.yml\"}\nformat:\n html:\n respect-user-color-scheme: true\n```\n\n## Other Highlights\n\n- Typst updated to 0.13.0\n- Pandoc updated to 3.6.3\n- New [`version` shortcode](/docs/authoring/version.qmd) to insert the version of Quarto used to build your document:\n \n ::: {layout-ncol=2 layout-valign=\"center\"}\n \n ```{.markdown shortcodes=\"false\"}\n Rendered with Quarto {{< version >}}\n ```\n ::: {.border .p-1}\n Rendered with Quarto {{< version >}}\n :::\n\n :::\n\n- Improvements to the `julia` engine: \n - [`juliaup` integration](/docs/computations/julia.qmd#juliaup-integration): Use specific versions of Julia in your notebooks.\n \n - [R and Python support](/docs/computations/julia.qmd#r-and-python-support): Include `{r}` and `{python}` executable code cells via the RCall and PythonCall packages.\n \n - [Caching](/docs/computations/julia.qmd#caching-julia): Save time rendering long-running notebooks by caching results.\n \n - [Revise.jl integration](/docs/computations/julia.qmd#revise.jl-integration): Automatically update function definitions in Julia sessions.\n\n\n## Acknowledgements\n\nWe'd like to say a huge thank you to everyone who contributed to this release by opening issues and pull requests:\n\n[AndreasThinks](https://github.com/AndreasThinks), \n[ArthurData](https://github.com/ArthurData), \n[BrendonChau](https://github.com/BrendonChau), \n[DanStuder](https://github.com/DanStuder), \n[DavidFirth](https://github.com/DavidFirth), \n[Eli-78-fas](https://github.com/Eli-78-fas), \n[EllaKaye](https://github.com/EllaKaye), \n[EmilHvitfeldt](https://github.com/EmilHvitfeldt), \n[EvoArt](https://github.com/EvoArt), \n[FMKerckhof](https://github.com/FMKerckhof), \n[FrankwaP](https://github.com/FrankwaP), \n[JanPalasek](https://github.com/JanPalasek), \n[Jocarnail](https://github.com/Jocarnail), \n[MHellmund](https://github.com/MHellmund), \n[MichaelHatherly](https://github.com/MichaelHatherly), \n[Noghpu](https://github.com/Noghpu), \n[PeneLoopy](https://github.com/PeneLoopy), \n[Rafnuss](https://github.com/Rafnuss), \n[SergeCroise](https://github.com/SergeCroise), \n[TonyFly3000](https://github.com/TonyFly3000), \n[actuaristai](https://github.com/actuaristai), \n[alex-r-bigelow](https://github.com/alex-r-bigelow), \n[andrewheiss](https://github.com/andrewheiss), \n[ant-durrant](https://github.com/ant-durrant), \n[antoine4ucsd](https://github.com/antoine4ucsd), \n[arnaudgallou](https://github.com/arnaudgallou), \n[aronatkins](https://github.com/aronatkins), \n[arthurgailes](https://github.com/arthurgailes), \n[bkowshik](https://github.com/bkowshik), \n[boshek](https://github.com/boshek), \n[cbrnr](https://github.com/cbrnr), \n[cl-roberts](https://github.com/cl-roberts), \n[cmadland](https://github.com/cmadland), \n[coatless](https://github.com/coatless), \n[deepayan](https://github.com/deepayan), \n[devmcp](https://github.com/devmcp), \n[dhimmel](https://github.com/dhimmel), \n[dkapitan](https://github.com/dkapitan), \n[dmenne](https://github.com/dmenne), \n[eamcvey](https://github.com/eamcvey), \n[edavidaja](https://github.com/edavidaja), \n[fredguth](https://github.com/fredguth), \n[fuhrmanator](https://github.com/fuhrmanator), \n[gadenbuie](https://github.com/gadenbuie), \n[github-actions[bot]](https://github.com/apps/github-actions), \n[glin](https://github.com/glin), \n[gwbrck](https://github.com/gwbrck), \n[hchulkim](https://github.com/hchulkim), \n[hguturu](https://github.com/hguturu), \n[hturner](https://github.com/hturner), \n[ihrke](https://github.com/ihrke), \n[jdutant](https://github.com/jdutant), \n[jenslaufer](https://github.com/jenslaufer), \n[jkrumbiegel](https://github.com/jkrumbiegel), \n[jmgirard](https://github.com/jmgirard), \n[joelostblom](https://github.com/joelostblom), \n[kandolfp](https://github.com/kandolfp), \n[kapsner](https://github.com/kapsner), \n[kazuyanagimoto](https://github.com/kazuyanagimoto), \n[kdheepak](https://github.com/kdheepak), \n[kingo55](https://github.com/kingo55), \n[knuesel](https://github.com/knuesel), \n[kubu4](https://github.com/kubu4), \n[kv9898](https://github.com/kv9898), \n[kylie-foster](https://github.com/kylie-foster), \n[loneguardian](https://github.com/loneguardian), \n[lwjohnst86](https://github.com/lwjohnst86), \n[ma2048](https://github.com/ma2048), \n[markjholmes](https://github.com/markjholmes), \n[maurosilber](https://github.com/maurosilber), \n[mipmip](https://github.com/mipmip), \n[mroavi](https://github.com/mroavi), \n[mroberts1](https://github.com/mroberts1), \n[msh855](https://github.com/msh855), \n[mvuorre](https://github.com/mvuorre), \n[nathanj3](https://github.com/nathanj3), \n[odysseu](https://github.com/odysseu), \n[parmsam](https://github.com/parmsam), \n[peter-gy](https://github.com/peter-gy), \n[pvelayudhan](https://github.com/pvelayudhan), \n[raffaem](https://github.com/raffaem), \n[robmcd](https://github.com/robmcd), \n[ryanzomorrodi](https://github.com/ryanzomorrodi), \n[stragu](https://github.com/stragu), \n[sun123zxy](https://github.com/sun123zxy), \n[t-kalinowski](https://github.com/t-kalinowski), \n[temospena](https://github.com/temospena), \n[tjni](https://github.com/tjni), \n[torven-schalk](https://github.com/torven-schalk), \n[turcotte](https://github.com/turcotte), \n[wenyaoliu](https://github.com/wenyaoliu), \n[yhkee0404](https://github.com/yhkee0404).\n\n",
0 commit comments