bookdown — Author Books and Technical Documents with R Markdown

Introduction

bookdown is an R package by Yihui Xie that makes it straightforward to write books and long-form documents using R Markdown. It handles cross-references, numbered figures and tables, citations, and multi-file chapter organization. Many published data science textbooks, including R for Data Science, are authored with bookdown.

What bookdown Does

• Merges multiple R Markdown files into ordered chapters with a shared bibliography
• Generates cross-references for figures, tables, equations, theorems, and sections
• Outputs to HTML (GitBook style), PDF (via LaTeX), EPUB, and Word from one source
• Embeds executable R code chunks whose output (plots, tables) is rendered inline
• Supports custom LaTeX and HTML templates for publisher-specific formatting

Architecture Overview

bookdown builds on top of knitr (for executing code) and Pandoc (for format conversion). It reads an index file or _bookdown.yml config that lists chapter files in order. Each chapter is an R Markdown file. bookdown merges them, resolves cross-references, numbers figures and tables, and passes the result to Pandoc for final rendering. The GitBook output format provides a searchable, navigable HTML book with a sidebar table of contents.

Self-Hosting & Configuration

• Install from CRAN: install.packages("bookdown")
• Create a new book project via RStudio's project wizard or bookdown::create_book()
• Configure chapter order and output formats in _bookdown.yml
• Deploy HTML books to GitHub Pages, Netlify, or Bookdown.org
• Customize LaTeX preamble in preamble.tex for PDF output styling

Key Features

• Cross-references with @ref(fig:label) syntax work across all output formats
• Numbered and captioned figures, tables, and equations with automatic numbering
• Multi-format output from a single source ensures consistency across HTML and PDF
• Citation support via BibTeX or CSL with Pandoc's citeproc
• Extensible with custom output formats and Pandoc templates

Comparison with Similar Tools

• Quarto — the next-generation successor supporting Python, Julia, and Observable in addition to R; bookdown remains widely used for R-only projects
• Sphinx (Python) — reStructuredText-based documentation tool; bookdown is more natural for R users and embeds executable R code
• Jupyter Book — builds books from Jupyter notebooks; bookdown integrates deeply with the R Markdown ecosystem
• LaTeX — full typesetting control but steeper learning curve; bookdown offers Markdown simplicity with LaTeX output
• MkDocs / mdBook — static doc generators from Markdown; bookdown adds executable code and academic features (cross-refs, citations)

FAQ

Q: Can I use bookdown without R code? A: Yes. bookdown works as a pure Markdown book authoring tool; R code chunks are optional.

Q: How do I publish a bookdown book online? A: Render to HTML and deploy the _book/ folder to GitHub Pages, Netlify, or bookdown.org (a free hosting service by RStudio).

Q: Does bookdown support languages other than R? A: Code chunks can run Python, SQL, Bash, and other languages supported by knitr engines, but the tooling is R-centric.

Q: Can I create a thesis or dissertation with bookdown? A: Yes. Community templates like thesisdown provide university-specific formatting. bookdown handles the structure, numbering, and bibliography management.

Sources

• https://github.com/rstudio/bookdown
• https://bookdown.org/