An Extension Can Ship a Whole Quarto Project Type
A Quarto extension can contribute a project type, not only a format or a filter. This post shows how quarto-atelier gives every one of my documentation sites the same website configuration from a short _quarto.yml, how a site overrides one value, and where the approach stops.
Quarto Wizard 3.3: Typst Preview and Schema Validation
Quarto Wizard 3.3 compiles the Typst block under your cursor and shows the image beside the editor. It also publishes the Lua validator of the extension schema vocabulary, so an extension can check its own options during a render.
Gribouille 0.7.0: A Theme from Your Brand, and Plots That Fit
Gribouille 0.7.0 builds a theme from a parsed _brand.yml, so a document’s plots follow the same brand as its prose. A plot now draws at any size that gives it room to draw, keeps to the width and height you set, and says how much room it needs when it cannot. The line geoms take arrowheads through the new arrow() helper, a log axis places and labels its breaks as powers, and large plots draw several times faster. The breaking changes are the new arrow specification and the plots that now fail instead of drawing past their canvas.
A Clinical Study Report in Quarto, End to End
A complete Quarto project that turns public CDISC pilot data into a sponsor-style clinical study report, rendered to a branded Typst PDF and an HTML site from one source. This post walks through the format extension, the Typst template, the brand, the output index, and the checks.
Gribouille 0.6.0: Wrangling Data and Breaks That Land on Round Numbers
Gribouille 0.6.0 adds an experimental set of data wrangling verbs, so grouped aggregation, reshaping, and joining happen in the document instead of in a script you run beforehand. Automatic axis breaks now come from the extended Wilkinson search, and breaks-width(), breaks-pretty(), breaks-extended(), and breaks-quantile() let you place them yourself. Axis ticks are themed through a single element-tick, which is the breaking change of the release. The documentation fills its gaps too, with a new wrangling guide, a section on tick theming, and complete argument tables on every scale page.
Stop Duplicating Your Quarto Source
Writing HTML, a Typst PDF, and a reveal.js deck from one Quarto source runs into three recurring problems: heading levels, format-specific attributes, and slide breaks. This post shows the three filters I wrote for them, and how they work together on a single document.
Gribouille 0.5.0: Native Density, and Scales Keyed by Aesthetic
Gribouille 0.5.0 brings native kernel density estimation to Typst: densities, violins, two-dimensional densities, ridgelines, and a LOESS smoother, all computed in pure markup. It also rewrites the scale system so the per-aesthetic scale-* constructors collapse into a single keyed scales(), the largest breaking change of the release. Streamgraphs, bump charts, and waffle charts join the roster too.
Serving a Shiny App and Its Docs from One Process
great-docs generates an API reference documentation site from a Python package’s docstrings. Shiny for Python serves the interactive app. A Starlette wrapper mounts both at the same origin so one command is all you need.
R Package Architecture: Shiny, Quarto, targets, and S7
Most of my work is in R: statistical analysis of omics data, building packages. This post walks through the architecture I use to structure an analysis package that embeds a modular Shiny app and delivers branded reports through a bundled Quarto extension.
Gribouille 0.4.0: Temporal Scales, Any-Glyph Markers, and a Finer Grid
Gribouille 0.4.0 teaches the scales to read dates and times from plain strings, lets any character stand in as a point marker, and splits the panel grid into a major and minor cascade with minor gridlines on by default. It also renames labs() to labels(), and closes with a real chart built from the package’s own GitHub star history.
Gribouille 0.3.0: Finer Guide Control and a Themed Compose
Gribouille 0.3.0 gives guides and axes a much finer on/off switch, lets compose() carry its own theme, and makes geom-area() stack by default. A long list of legend and annotation fixes rounds it out.
Why Quarto Stuck: Four Years from a Biostatistician’s Desk
After four years of daily use, Quarto has replaced R Markdown across my reports, slides, websites, and books. I reflect on what made it stick: cleaner defaults, real multi-language support, the extension system, and Typst for PDF.
Gribouille 0.2.0 and 0.2.1: Composing Plots and a Sturdier Core
Gribouille 0.2.0 is the first feature update since the launch, and 0.2.1 follows shortly after. compose() can now number panels, nest, carry its own titles, hoist a single shared legend, and line panels up across the grid with align-panels, facet-grid() gains free scales, and labels and guides get tidier controls. Most of the work, though, went into the internals, where a long list of panics became clear errors and correct output.
Build LinkedIn Carousels with Typst: the slide Layout
A LinkedIn carousel is just a multi-page document. This short tutorial shows how a tiny Typst slide helper gives every page a full-bleed background with consistent padding, then how to compile the deck to PDF and preview frames. It ends with a ready-to-paste LLM prompt that drafts a similar carousel from scratch.
Gribouille: a Grammar of Graphics for Typst
Gribouille is a new Typst package that brings Wilkinson’s grammar of graphics natively into Typst, in the spirit of ggplot2 and plotnine. Version 0.1.0 ships alongside an updated Typst Render Quarto extension whose new typst_define() helper streams arbitrary Python and R values, from a scalar to a Polars DataFrame, straight into Typst code blocks.
Quarto Reveal.js Extensions to Sharpen Your Slides
A short tour of small Quarto extensions that make Reveal.js presentations tidier and more interactive. Coordinated list fragments, animated code annotations, cascading headings, and keyboard-friendly tabsets, each with a minimal embedded slidedeck.
Branded Figures and Tables in R and Python with Quarto
Style ggplot2, plotnine, gt, and great_tables outputs using Quarto’s brand feature by reading brand configuration from the QUARTO_EXECUTE_INFO environment variable at render time.
Building Quarto Typst Templates: Advanced Patterns (Part 2)
This tutorial continues from Part 1, exploring advanced patterns for Quarto Typst extensions. You will learn handler factories, configuration systems, type-safe value conversion, and WCAG-aware badges.
Building Quarto Typst Templates: The Lua-Typst Bridge (Part 1)
This tutorial introduces the dual-layer architecture for building Quarto Typst templates. You will learn how Lua filters and Typst functions work together to transform markdown elements into styled PDF components.
Document-Type Dispatching in Quarto Typst Extensions
Learn how to build a central dispatcher function that routes to different Typst templates based on document type. This pattern enables clean separation between document types like reports, letters, and CVs.
Quarto Wizard 2.0.0: Native Extension Management and Batch Operations
Quarto Wizard 2.0.0 brings native extension management without CLI dependency, batch operations, multi-extension selection, and a new documentation website.
Quarto Extensions Updater: Automating Extension Maintenance with GitHub Actions
Discover how to automate Quarto extension updates in your repositories using a Dependabot-style GitHub Action that keeps your extensions current with zero manual effort.
Optimising VS Code and Positron for Quarto: Essential Settings for Better Editing
Discover the custom settings I use in VS Code and Positron to enhance my Quarto document editing workflow, from improved Git diffs to better visual guides for nested divs.
Lua Best Practices for Quarto Extensions: Building Maintainable and Robust Extensions
This guide explores essential practices drawn from Quarto’s extensions and community standards, covering project structure, error handling, documentation, and release management to help transform your extensions into reliable, community-friendly tools that stand the test of time.
Quarto Wizard 1.0.0: Democratising Quarto Extension Management
Introducing a game-changing extension for VS Code and Positron that transforms Quarto extensions management with an intuitive GUI for extensions and templates.
How to use GitHub Codespaces to simplify your Quarto workshops
In this post, I’ll teach you the basics of GitHub Codespaces and how to use them to make it easier to teach using Quarto.
Quarto: Unleash Dynamic Tabset Navigation & Polished PDF Exports
Discover how to supercharge your Quarto presentations with interactive tabset navigation in Reveal.js and create stunning, professional PDFs. Get ready to dazzle your audience!
Quarto: Publishing to GitHub Pages
In this guide, I’ll explore various methods to publish your Quarto projects to GitHub Pages. I’ll cover both manual and automated approaches to help you choose the best fit for your workflow.
Quarto Q&A: How to have images for both light and dark theme?
In this blog post of the “Quarto Q&A” series you will learn how to generate images for light and dark theme using knitr and switch between them when changing theme.
Quarto Q&A: How to publish your Quarto content as a Docker container?
In this blog post of the “Quarto Q&A” series you will learn how to publish your Quarto project as a Docker container.
Quarto Q&A: How to use non-default LaTeX packages/macros in MathJax?
A second blog post of the “Quarto Q&A” series on how to activate additional MathJax packages in a Quarto document.
Quarto Q&A: How to have labels and captions for an unknown number of tables?
A small example of how to automatically have labels and captions for an unknown number of tables in Quarto, using knitr and R.
Add a Floating Table of Contents in blogdown
How to have a table of contents (TOC) on either the left or the right side of a post? I have an answer!
A ggplot2 and gganimate Version of Pac-Man
The story of ggpacman. Or how to build a useless but fun R package to make a GIF of the game Pac-Man.