17 Books
| System | Valid input files | Compatibility with Python & R | Blog posts (tags, dates, filters) ? | Nice examples | Additional details |
|---|---|---|---|---|---|
| Jupyter Book Documentation |
- Markdown .md- Jupyter notebook .ipynb- MyST markdown notebook .md- reStructured Text .rst (not recommended)[source] |
Python tool. Would probably only use with R if you were working with R in .ipynb. Possible to convert .Rmd to ipynb or MyST |
Not found example | SAMueL-1 SAMueL-2 |
Easy integration with BinderHub and Google Colab [source] Uses Sphinx to build book [source] |
| Sphinx Documentation |
- reStructured Text .rst (default)- Markdown .md- Jupyter notebook .ipynb (with nbsphinx and MyST-NB) |
Designed for Python, didn’t easily run into R implementation, but examples here in various languages | Yes | pyOpenSci Little book of R for biomedical statistics Chris Holdgraf’s blog |
Thumbnail gallery, Binder, nbviewer [source] |
| Quarto Documentation |
- Cross-language Quarto markdown .qmd (which combines markdown and executable code)-Jupyter notebook .ipynb- Markdown .md- R markdown .Rmd[source] |
Explicitly supports dynamic content from Python, R, Julia and Observable [source] Comparison with Rmd |
Well supported natively Tutorial 1 Tutorial 2 Tutorial 3 |
ddanieltan’s blog Quarto’s blog - github, site R for Data Science Python for Data Analysis HSMA DES Book - github, site |
Huge range of supported output formats [source] |
| Jekyll | - Markdown .md- HTML |
Written in Ruby. Creates simple static sites. | Exeter RSE Workshop - github, site Ruby’s website |
||
| Mkdocs Documentation |
- Markdown .mdSeems possible for others but more designed for markdown? |
Designed for Python | Yes with Material for Mkdocs plugin | Material for MkDocs - github, site Cookiecutter Data Science - github, site |
Material for MkDocs provides additional features |
| Bookdown Documentation |
- R Markdown .Rmd |
Designed for R | R Markdown Definitive Guide R Markdown Cookbook |
||
| Blogdown Documentation |
- R Markdown .Rmd |
Designed for R | List of blogs | Built on Hugo [source] | |
| Hugodown Documentation |
- R Markdown .Rmd |
Designed for R | List of blogs | Built on Hugo | |
| Distill for R Markdown Documentation |
- R Markdown .Rmd |
Designed for R | Yes natively (eg. set up project as blog or website) | Piping Hot Data Tidy models Before I sleep |
Reflections on RMarkdown, Distill, Bookdown and Blogdown.
Paid: https://www.gitbook.com/pricing
Other random noted down options not explored: * Sandpaper, pegboard and varnish - example: https://carpentries-lab.github.io/good-enough-practices/index.html * Sweave/LaTeX RStudio/LaTeX Pandoc SageMath Colab Notebooks Nbconvert Pelican Org mode DocOnce Scribus Madoko Texinfo