Skip to content

tufte

0.15.0Package record

Tufte's Styles for R Markdown Documents

1packages dependsuggested by 10
75.2Kdownloads / year
76.0%test coverage
13/13flavors OK

Overview

About

Provides R Markdown output formats to use Tufte styles for PDF and HTML output.

Changes in 0.15.0

New features

  • tufte_handout() and tufte_book() gain a margin_fig_pos argument for controlling the vertical offset of margin figures globally. Set in YAML (margin_fig_pos: "0cm"), via knitr::opts_chunk$set(), or per-chunk. Per-chunk fig.pos still overrides it, and a global opts_chunk$set(fig.pos = ...) (intended for regular figures) no longer leaks onto margin chunks (#62).
  • New tufte_handout2(), tufte_book2(), and tufte_html2() wrap the corresponding bookdown output formats, enabling text references (ref:label) in figure and table captions and cross-references. Markdown links in fig.cap are now converted to LaTeX. Requires the bookdown package (suggested) (#60).
Show all changes in 0.15.0Hide the rest of the changes in 0.15.0

Minor improvements and fixes

  • fig.margin = TRUE (and fig.fullwidth = TRUE) are now honoured in HTML output when fig.align is set. The margin/fullwidth wrapper was previously dropped because the figure hook missed the style attribute added by knitr (#54).
  • The obsolete usenames option is no longer passed to the xcolor LaTeX package, suppressing a warning on TeX Live 2022+ (#127).
  • quote_footer() now renders an em-dash consistently across tufte and non-tufte outputs when the caller writes a leading "---". For non-tufte HTML the leading "---" is stripped to avoid doubling with Bootstrap's ::before em-dash; for tufte HTML an em-dash glyph is inserted in the markup; for LaTeX the leading "---" is preserved so pandoc's smart-punctuation extension converts it (#73).
  • quote_footer() now right-aligns the footer in non-tufte HTML output (e.g. html_document, including bslib Bootstrap 4 and 5 themes) and tags it with class="blockquote-footer" so Bootstrap 4/5 class-based styling applies. quote_footer() no longer warns when called outside a pandoc context, so it can be used unconditionally in inline R expressions (#73).
  • tufte_handout() and tufte_book() no longer place pandoc's \citep and \citet natbib citations inline when citation_package: natbib is used. The patched tufte-common.def routes both through the margin sidenote machinery; \citet keeps its textual "Author (Year)" form inline while adding the full reference to the margin. Suppress-author citations ([-@key], emitted as \citeyearpar) are intentionally left inline (thanks, @jlorieau, #48).
  • tufte_handout() and tufte_book() use fig_crop = "auto" by default (matching rmarkdown::pdf_document()), avoiding a spurious warning about pdfcrop when crop tools are not installed (thanks, @sandhya9215, #124).
  • tufte_html() no longer drops nocite references when link-citations: yes. References without in-text citations are preserved in the bibliography section at the bottom of the document (#35).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 1.1 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-04
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 0.15.0
READMEYes · 207 wordsVignettesNoNEWSYes · 100% structured · mentions 0.15.0Citation fileNo
Help pages
2 (1 internal)includes a package overview page
Examples that run
100%1 run in a plain check
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
50%

Downloads

75.2K
CRAN downloads in the past year
Rank #1,571 · ~206/day · ~6.3K/mo
Daily download trend is not available in this view yet.
4.2K30 days
14.9K90 days
75.2K1 year
Compare downloads with other packages →
Also on1.7K r2u4 autocran2.5K conda_forge92 c2d4u

Repository

433Stars
110Forks
10Open issues
0Open PRs
15Releases
256Commits
13Commit identities
tuftetufte-styler-packager-markdown
256 commits · Last activity 2026-07-07 · -0.2% stars, 30d · Default branch at 0.15.0.9000, ahead of CRAN 0.15.0 (checked 2026-10-21)
Responsiveness
How these are sampled
PRs merged (all time)
90%
Median days to close, 50 most recently updated closed issues
10
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-10-14 · 4162026-09-28 · 433
PracticesBeta

14 development-tooling and community-health practices detected across 6 families in the upstream repository

Checks run against github.com/rstudio/tufte 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 (3)
Code of conductContributing guideIssue templates
Docs source (2)
README.Rmd

GitHub Pages site last deployed 2026-05-22

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 2 practices
CRAN release process (2)
cran-comments.mdrevdep/
Lint, format, editor (4)
Lint workflowAirVS CodeRStudio project
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-04-24
    Seen in the repository: .claude
    Named in .Rbuildignore: .claude
    Named in .gitignore: .claude
  • Gemini CLIfirst seen on or before 2026-07-18
    Config: a file or ignore line, not recorded which
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
10 external dependencies (excludes base and recommended)

Installing tufte adds 25 packages (14 with compiled code, 18 MB of source tarballs). Heaviest: bslib 5.6 MB, sass 2.9 MB, rmarkdown 2.1 MB.

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

People & History

People (6)
Contributor, Maintainer since 0.12 (2022) · added in 0.10
Author
Contributor
Tufte CSS in inst/rmarkdown/templates/tufte_html/resources
Contributor · added in 0.3
Copyright holder, Funder · added in 0.13

Previously maintained by Yihui Xie (0.1 to 0.11).

Listed in earlier versions (2)
RStudio, Inc.
no longer listed · 0.1 to 0.5
RStudio, PBC
no longer listed · 0.6 to 0.12
Releases (15)

Pick two releases to compare their code metrics.

Show 11 earlier eventsHide 11 earlier events
  • R
    R 4.0.0 released · 2020-04-24
  • 0.5
    record
    2019-05-12 · diff ↗
  • R
    R 3.6.0 released · 2019-04-26
  • 0.4
    record
    2018-07-15 · diff ↗
  • R
    R 3.5.0 released · 2018-04-23
  • 0.3
    record
    2018-01-24 · diff ↗
  • R
    R 3.4.0 released · 2017-04-21
  • R
    R 3.3.0 released · 2016-05-03
  • 0.2
    record
    2016-02-07 · diff ↗
  • 0.1
    record
    2016-01-20
  • R
    R 3.2.0 released · 2015-04-16

Package metadata

First published
2016-01-20
Total releases
15 / 10 yrs
License
GPL-3 OSI
Download size
274 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("tufte")
Dervieux, C., Posit Software, PBC, Allaire, J., Liepmann, D., Oles, A., & Xie, Y. (2026). tufte: Tufte's Styles for R Markdown Documents (Version 0.15.0) [Computer software]. https://doi.org/10.32614/CRAN.package.tufte

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 tufte version 0.15.0 [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