Skip to content

distill

1.6Package record

'R Markdown' Format for Scientific and Technical Writing

2packages dependsuggested by 1
24.5Kdownloads / year
50.2%test coverage
13/13flavors OK

Overview

About

Scientific and technical article format for the web. 'Distill' articles feature attractive, reader-friendly typography, flexible layout options for visualizations, and full support for footnotes and citations.

Changes in 1.6
  • RSS feed creation now works correctly for listings when no description is provided in one of the Rmd post (thanks, \@cpsyctc, \@apeterson91, #490, #448).
  • Fix an issue with line numbering on code chunks when highlight-downlit: false by tweaking Pandoc's default CSS rules (thanks, \@SES-CE, #473).
  • Internally use format() instead of as.character() with Dates to account for argument format= deprecation in R 4.3.0 (thanks, \@mbojan, #488).
  • Add a subtitle variable in HTML template placed between title and categories (thanks, \@dicook, #480).
  • Add author name in orcid image alt text (thanks, \@mitchelloharawild , \@ajrgodfrey, #494, rjournal/rjtools#86).
  • In distill_article(), metadata header in HTML is separated by <hr> to improve accessibility (thanks, @mitchelloharawild, #495, @ajrgodfrey, #rjournal/rjtools#92)

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 1.5 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.6
README· In the repository, left out of the releaseVignettes· In the repository, left out of the releaseNEWSYes · 100% structured · mentions 1.6Citation fileNoWebsiteYes
Help pages
10 (1 internal)includes a package overview page
Examples that run
0%4 never run
Exported functions with examples
44%
Documented parameters
97%
Return-value docs
11%
Help pages citing references
0%

Downloads

24.5K
CRAN downloads in the past year
Rank #3,129 · ~67/day · ~2K/mo
Daily download trend is not available in this view yet.
1.5K30 days
4K90 days
24.5K1 year
Compare downloads with other packages →
Also on1.5K r2u3 autocran2.1K conda_forge86 c2d4u

Repository

426Stars
58Forks
145Open issues
4Open PRs
3Releases
1,414Commits
26Commit identities
License file reads as Apache-2.0 · 1,414 commits · Last activity 2023-11-22 · +0.2% stars, 30d · Default branch at 1.6.1, ahead of CRAN 1.6 (checked 2026-10-21)
Responsiveness
How these are sampled
PRs merged (all time)
92%
Median days to close, 50 most recently updated closed issues
19
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-04-15 · 4222026-10-06 · 426
PracticesBeta

9 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/rstudio/distill on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (2)
Code of conductContributing guide
Docs source (3)
README.Rmdpkgdown

GitHub Pages site last deployed 2023-11-22

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 1 practice
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
28 external dependencies (excludes base and recommended)

Installing distill adds 48 packages (27 with compiled code, 34 MB of source tarballs). Heaviest: stringi 11 MB, bslib 5.6 MB, sass 2.9 MB.

Depends (0)
none
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
2direct
1indirect
Imports 2
Suggested by 1
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

People & History

People (12)
Author, Maintainer since 1.4 (2022) · added in 1.4
Author
Author · added in 1.0
Author
Contributor, Copyright holder
whoami
Contributor, Copyright holder
https://github.com/lancedikson/bowser
Contributor, Copyright holder
https://distill.pub/guide/
Contributor · added in 0.8
Contributor, Copyright holder
https://www.webcomponents.org/polyfills/
Contributor, Copyright holder
https://wicky.nillia.ms/headroom.js/
Copyright holder, Funder · added in 1.6

Previously maintained by JJ Allaire (0.7 to 1.3).

Listed in earlier versions (2)
RStudio, Inc.
no longer listed · 0.7 to 1.3
RStudio, PBC
no longer listed · 1.4 to 1.5
Releases (9)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • 1.6Latest
    record
    2023-10-06 · current release · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 1.5
    record
    2022-09-07 · diff ↗
  • 1.4
    record
    2022-05-12 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 1.3
    record
    2021-10-13 · diff ↗
  • R
    R 4.1.0 released · 2021-05-18
  • 1.2
    record
    2021-01-13 · diff ↗
  • 1.1
    record
    2020-12-02 · diff ↗
  • 1.0
    record
    2020-10-22 · diff ↗ ·
    added 3 exports
    create_article, create_theme, rename_post_dir
  • 0.8
    record
    2020-06-04 · diff ↗
  • R
    R 4.0.0 released · 2020-04-24
  • 0.7
    record
    2019-05-03
Show 1 earlier eventHide 1 earlier event
  • R
    R 3.6.0 released · 2019-04-26

Package metadata

First published
2019-05-03
Total releases
9 / 7 yrs
License
Apache License 2.0 OSI
Download size
241 KB
Appears in task views

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("distill")
Dervieux, C., Posit Software, PBC, Allaire, J., Csárdi, G., Demchenko, D., Google LLC, , Iannone, R., Presmanes Hill, A., Seo, J., The Polymer Authors, , Williams, N., & Xie, Y. (2023). distill: 'R Markdown' Format for Scientific and Technical Writing (Version 1.6) [Computer software]. https://doi.org/10.32614/CRAN.package.distill

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for distill version 1.6 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy