<p><div><div><div><div data-width="100" data-show-faces="false" data-send="true" data-layout="button_count" data-height="21" data-href="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/"></div></div><div><a data-url="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/" data-counturl="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/" data-count="horizontal" data-text="Announcing bookdown: Authoring Books and Technical Documents with R Markdown" class="twitter-share-button" data-via="rbloggers" href="https://twitter.com/share"></a></div><div></div></div><div></div></div>
<div>
(This article was first published on <strong><a href="https://blog.rstudio.org/2016/12/02/announcing-bookdown/"> RStudio Blog</a></strong>, and kindly contributed to <a rel="nofollow" href="https://www.r-bloggers.com/">R-bloggers)</a> </div>
<p>We have released the R package <strong>bookdown</strong> (v0.3) to <a target="_blank" rel="nofollow" href="https://cran.rstudio.com/package=bookdown">CRAN</a>. It may be old news to some users, but we are happy to make an official announcement today. To install the package from CRAN, you can</p>
<pre>install.packages(&quot;bookdown&quot;)</pre>
<p>The <strong>bookdown</strong> package provides an easier way to write books and technical publications than traditional tools such as LaTeX and Word. It inherits the simplicity of syntax and flexibility for data analysis from R Markdown, and extends R Markdown for technical writing, so that you can make better use of document elements such as figures, tables, equations, theorems, citations, and references, etc. Similar to LaTeX, you can number and cross-reference these elements with <b>bookdown</b>. <span></span>Below are some screenshots to show what <strong>bookdown</strong> can produce:</p>
<div data-shortcode="caption" class="wp-caption"><img sizes="(max-width: 490px) 100vw, 490px" alt="An example of figure numbers and captions" class="wp-image-3753" src="https://i0.wp.com/rstudioblog.files.wordpress.com/2016/12/screen-shot-2016-12-01-at-2-39-28-pm.png?w=456&ssl=1" data-recalc-dims="1">
<p class="wp-caption-text">An example of figure numbers and captions in <strong>bookdown</strong>.</p>
</div>
<div data-shortcode="caption" class="wp-caption"><img sizes="(max-width: 490px) 100vw, 490px" alt="Examples of table numbers and captions" class="wp-image-3756" src="https://i1.wp.com/rstudioblog.files.wordpress.com/2016/12/screen-shot-2016-12-01-at-2-40-20-pm.png?w=456&ssl=1" data-recalc-dims="1">
<p class="wp-caption-text">Examples of table numbers and captions in <strong>bookdown</strong>.</p>
</div>
<div data-shortcode="caption" class="wp-caption"><img sizes="(max-width: 490px) 100vw, 490px" alt="Math equations" class="wp-image-3759" src="https://i0.wp.com/rstudioblog.files.wordpress.com/2016/12/screen-shot-2016-12-01-at-2-41-18-pm.png?w=456&ssl=1" data-recalc-dims="1">
<p class="wp-caption-text">Math equations in <strong>bookdown</strong>.</p>
</div>
<p>Your document can even include live examples (e.g. <a target="_blank" rel="nofollow" href="http://htmlwidgets.org/">HTML widgets</a> and <a target="_blank" rel="nofollow" href="https://shiny.rstudio.com/">Shiny apps</a>) so readers can interact with them while reading the book. The book can be rendered to multiple output formats, including LaTeX/PDF, HTML, EPUB, and Word, thus making it easy to put your documents online. The style and theme of these output formats can be customized. Most features apply to all output formats, e.g., you can also number equations and theorems in HTML output.</p>
<div class="wp-caption"><a target="_blank" rel="nofollow" href="https://bookdown.org/yihui/bookdown"><img alt="The bookdown book" src="https://i1.wp.com/bookdown.org/yihui/bookdown/images/cover.jpg?w=250&ssl=1" data-recalc-dims="1"></a>
<p class="wp-caption-text">The bookdown book.</p>
</div>
<p>You can find the full documentation at <a target="_blank" rel="nofollow" href="https://bookdown.org/yihui/bookdown">https://bookdown.org/yihui/bookdown</a>. As a matter of fact, the documentation was written using <strong>bookdown</strong> (of course!), and its source is fully available <a target="_blank" rel="nofollow" href="https://github.com/rstudio/bookdown/tree/master/inst/examples">on GitHub</a>. The book is to be published by <a target="_blank" rel="nofollow" href="http://crcpress.com/product/isbn/9781138700109">Chapman &amp; Hall</a> by the end of this month (pre-order also available on <a target="_blank" rel="nofollow" href="http://a.co/0uHNbno">Amazon</a>). We used books and R primarily for examples in this book, but <b>bookdown</b> is not only for books or R. Most features introduced in this book also apply to other types of publications: journal papers, reports, <a target="_blank" rel="nofollow" href="https://github.com/cpsievert/phd-thesis">dissertations</a>, <a target="_blank" rel="nofollow" href="https://geanders.github.io/RProgrammingForResearch/">course handouts</a>, study notes, and even novels. You do not have to use R, either. Other choices of computing languages include Python, C, C++, SQL, Bash, Stan, JavaScript, and so on, although R is best supported. You can also leave out computing, for example, to write a novel.</p>
<p>There have been a large number of books published on <a target="_blank" rel="nofollow" href="https://bookdown.org/">https://bookdown.org</a>, and we hope you can find some inspiration there to start your own book.</p>
<p><img alt="mimic.gif" class="wp-image-3880" src="https://i0.wp.com/rstudioblog.files.wordpress.com/2016/12/mimic.gif?w=456&ssl=1" data-recalc-dims="1"></p>
<p>To be clear, the goal of <strong>bookdown</strong> is definitely not to replace sophisticated typesetting tools like LaTeX, but help authors focus on content (instead of appearance), and present common components of a technical document more easily using the Markdown syntax (such sections, quotes, figures, tables, and so on). To some degree, <strong>bookdown</strong> reinvented a small part of LaTeX in other formats (HTML, EPUB, Word). There are surely features of other typesetting tools that are unavailable in <strong>bookdown</strong>, in which case we encourage you to either submit a feature request with justifications, or take a deep breath and <a target="_blank" rel="nofollow" href="https://twitter.com/kwbroman/status/798938827876421633">say <strong>no</strong> to new features</a> to keep things simple (for your reference, the <strong>bookdown</strong> package and book didn’t exist about <a target="_blank" rel="nofollow" href="https://github.com/rstudio/bookdown/graphs/contributors">a year ago</a>).</p>
<p>Writing books can be highly addictive: it helps you organize your (random) thoughts and content into chapters and sections, and it is very rewarding to see the number of pages grow each day like a little baby. You can do things that you normally cannot/won’t do in journal papers. For example, you can thank your kids in the preface (without whom you should have finished the book two years earlier). Choose a fresh and crispy font, and you simply cannot stop writing! With one click of a button, you can go directly from R Markdown documents to <a target="_blank" rel="nofollow" href="https://bookdown.org/yihui/bookdown/bookdown.pdf">a PDF</a> that is ready to be printed by your publisher.</p>
<p>We hope you will enjoy <strong>bookdown</strong>. Please feel free to <a target="_blank" rel="nofollow" href="https://github.com/rstudio/bookdown/issues">let us know</a> if you have any feedback, or ask technical questions on <a target="_blank" rel="nofollow" href="http://stackoverflow.com/questions/tagged/bookdown">StackOverflow</a>.</p>
<p> <a target="_blank" rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rstudioblog.wordpress.com/3720/"><img alt="" src="http://feeds.wordpress.com/1.0/comments/rstudioblog.wordpress.com/3720/" border="0"></a> <img alt="" src="https://i1.wp.com/pixel.wp.com/b.gif?resize=1%2C1&ssl=1" border="0" data-recalc-dims="1"></p>
<p><div><div><div><div data-width="55" data-show-faces="false" data-send="true" data-layout="box_count" data-height="62" data-href="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/"></div></div><div><a data-url="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/" data-counturl="https://www.r-bloggers.com/announcing-bookdown-authoring-books-and-technical-documents-with-r-markdown/" data-count="vertical" data-text="Announcing bookdown: Authoring Books and Technical Documents with R Markdown" class="twitter-share-button" data-via="rbloggers" href="https://twitter.com/share"></a></div><div></div></div><div></div></div>
<div>
<div>To <strong>leave a comment</strong> for the author, please follow the link and comment on their blog: <strong><a href="https://blog.rstudio.org/2016/12/02/announcing-bookdown/"> RStudio Blog</a></strong>.</div>
<hr>
<a rel="nofollow" href="https://www.r-bloggers.com/">R-bloggers.com</a> offers <strong><a rel="nofollow" href="https://feedburner.google.com/fb/a/mailverify?uri=RBloggers">daily e-mail updates</a></strong> about <a title="The R Project for Statistical Computing" rel="nofollow" href="https://www.r-project.org/">R</a> news and <a title="R tutorials" rel="nofollow" href="https://www.r-bloggers.com/?s=tutorial">tutorials</a> on topics such as: <a title="Data science" rel="nofollow" href="https://www.r-bloggers.com/?s=data%20science">Data science</a>, <a title="Big Data" rel="nofollow" href="https://www.r-bloggers.com/?s=Big%20Data">Big Data, <a title="R jobs" rel="nofollow" href="https://www.r-users.com/">R jobs</a>, visualization (<a title="ggplot and ggplot2 tutorials" rel="nofollow" href="https://www.r-bloggers.com/?s=ggplot2">ggplot2</a>, <a title="Boxplots using lattice and ggplot2 tutorials" rel="nofollow" href="https://www.r-bloggers.com/?s=boxplot">Boxplots</a>, <a title="Maps and gis" rel="nofollow" href="https://www.r-bloggers.com/?s=map">maps</a>, <a title="Animation in R" rel="nofollow" href="https://www.r-bloggers.com/?s=animation">animation</a>), programming (<a title="RStudio IDE for R" rel="nofollow" href="https://www.r-bloggers.com/?s=RStudio">RStudio</a>, <a title="Sweave and literate programming" rel="nofollow" href="https://www.r-bloggers.com/?s=sweave">Sweave</a>, <a title="LaTeX in R" rel="nofollow" href="https://www.r-bloggers.com/?s=LaTeX">LaTeX</a>, <a title="SQL and databases" rel="nofollow" href="https://www.r-bloggers.com/?s=SQL">SQL</a>, <a title="Eclipse IDE for R" rel="nofollow" href="https://www.r-bloggers.com/?s=eclipse">Eclipse</a>, <a title="git and github, Version Control System" rel="nofollow" href="https://www.r-bloggers.com/?s=git">git</a>, <a title="Large data in R using Hadoop" rel="nofollow" href="https://www.r-bloggers.com/?s=hadoop">hadoop</a>, <a title="Web Scraping of google, facebook, yahoo, twitter and more using R" rel="nofollow" href="https://www.r-bloggers.com/?s=Web+Scraping">Web Scraping</a>) statistics (<a title="Regressions and ANOVA analysis tutorials" rel="nofollow" href="https://www.r-bloggers.com/?s=regression">regression</a>, <a title="principal component analysis tutorial" rel="nofollow" href="https://www.r-bloggers.com/?s=PCA">PCA</a>, <a title="Time series" rel="nofollow" href="https://www.r-bloggers.com/?s=time+series">time series</a>, <a title="finance trading" rel="nofollow" href="https://www.r-bloggers.com/?s=trading">trading</a>) and more...
<img height="1" alt="" width="1" src="http://feeds.feedburner.com/~r/RBloggers/~4/DCB4TcEyMtA"></a></div>