Tufte's Styles for R Markdown Documents
Overview
Provides R Markdown output formats to use Tufte styles for PDF and HTML output.
New features
tufte_handout()andtufte_book()gain amargin_fig_posargument for controlling the vertical offset of margin figures globally. Set in YAML (margin_fig_pos: "0cm"), viaknitr::opts_chunk$set(), or per-chunk. Per-chunkfig.posstill overrides it, and a globalopts_chunk$set(fig.pos = ...)(intended for regular figures) no longer leaks onto margin chunks (#62).- New
tufte_handout2(),tufte_book2(), andtufte_html2()wrap the corresponding bookdown output formats, enabling text references(ref:label)in figure and table captions and cross-references. Markdown links infig.capare 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(andfig.fullwidth = TRUE) are now honoured in HTML output whenfig.alignis set. The margin/fullwidth wrapper was previously dropped because the figure hook missed thestyleattribute added by knitr (#54).- The obsolete
usenamesoption is no longer passed to thexcolorLaTeX 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::beforeem-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, includingbslibBootstrap 4 and 5 themes) and tags it withclass="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()andtufte_book()no longer place pandoc's\citepand\citetnatbib citations inline whencitation_package: natbibis used. The patchedtufte-common.defroutes both through the margin sidenote machinery;\citetkeeps 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()andtufte_book()usefig_crop = "auto"by default (matchingrmarkdown::pdf_document()), avoiding a spurious warning aboutpdfcropwhen crop tools are not installed (thanks, @sandhya9215, #124).tufte_html()no longer dropsnocitereferences whenlink-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
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK14 OK2026-03-10
Documentation
- 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
Repository
- 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
Forks over time
Releases over time
Issues over time
PRs over time
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.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
Show all practicesHide 2 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-04-24Seen in the repository: .claudeNamed in .Rbuildignore: .claudeNamed in .gitignore: .claude
- Gemini CLIfirst seen on or before 2026-07-18Config: a file or ignore line, not recorded which
Dependencies
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.
Code & Tests
People & History
Previously maintained by Yihui Xie (0.1 to 0.11).
Pick two releases to compare their code metrics.
- 0.15.0Latest
- RR 4.6.0 released · 2026-04-24
- 0.14.02025-07-29 · diff ↗
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 0.132023-06-22 · diff ↗
- RR 4.3.0 released · 2023-04-21
- RR 4.2.0 released · 2022-04-22
- 0.122022-01-28 · diff ↗
- 0.112021-12-19 · diff ↗
- RR 4.1.0 released · 2021-05-18
- 0.102021-05-17 · diff ↗
- 0.92020-12-02 · diff ↗
- 0.82020-10-30 · diff ↗
- 0.72020-09-25 · diff ↗
- 0.62020-05-08 · diff ↗
Show 11 earlier eventsHide 11 earlier events
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")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.
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.