bookdown v0.21


Monthly downloads



Authoring Books and Technical Documents with R Markdown

Output formats and utilities for authoring books and technical documents with R Markdown.



Build Status Downloads from the RStudio CRAN mirror

bookdown logo

A open-source (GPL-3) R package to facilitate writing books and long-form articles/reports with R Markdown. Features include:

  • Generate printer-ready books and ebooks from R Markdown documents
  • A markup language easier to learn than LaTeX, and to write elements such as section headers, lists, quotes, figures, tables, and citations
  • Multiple choices of output formats: PDF, LaTeX, HTML, EPUB, and Word.
  • Possibility of including dynamic graphics and interactive applications (HTML widgets and Shiny apps)
  • Support for languages other than R, including C/C++, Python, and SQL, etc.
  • LaTeX equations, theorems, and proofs work for all output formats
  • Can be published to GitHub,, and any web servers
  • Integrated with the RStudio IDE
  • One-click publishing to

The full documentation is the bookdown book, freely available at You may see "Get Started" at to know how to get started with writing a book. The source of the bookdown book (and a complete working example) can be found in inst/examples/ of this repo. See for more information and featured books. You are welcome to send us feedback using Github issues or ask questions on StackOverflow with the bookdown tag.

Functions in bookdown

Name Description
resolve_refs_html Resolve figure/table/section references in HTML
serve_book Continuously preview the HTML output of a book using the servr package
pdf_book Convert R Markdown to a PDF book
kindlegen A wrapper function to convert EPUB to the Mobipocket format
calibre A wrapper function to convert e-books using Calibre
render_book Render multiple R Markdown documents into a book
publish_book Publish a book to the web
html_document2 Output formats that allow numbering and cross-referencing figures/tables/equations
gitbook The GitBook output format
bookdown_site R Markdown site generator for bookdown
epub_book The EPUB e-book format
bookdown-package Authoring Books and Technical Documents with R Markdown
fence_theorems Convert the syntax of theorem and proof environments from code blocks to fenced Divs
clean_book Clean up the output files and directories from the book
html_chapters Build book chapters into separate HTML files
build_chapter Combine different parts of an HTML page
No Results!

Last month downloads


Include our badge in your README