______
/ ⚡ \
/litedown\
\ ⚡ /
\______/R Markdown Reimagined
litedown turns Markdown and R Markdown into HTML and LaTeX/PDF, with no knitr and no Pandoc. It imports only one R package, xfun, and renders Markdown with a bundled and patched copy of the cmark-gfm C library.
Computing: run code chunks and inline code in R, or in other languages via engines such as JavaScript, CSS, Mermaid, and shell commands. Chunk options control code, text output, figures, tables, caching, and even the order of execution.
Markdown: GFM plus math, footnotes, superscripts/subscripts, raw HTML/LaTeX blocks, element attributes, cross-references, citations, and callouts.
Output: single HTML documents (with resources embedded if you want), LaTeX and PDF, and lightweight HTML articles, slides, and paged HTML (for print), styled with small vanilla CSS/JS files from lite.js.
Projects: books and websites from a directory of documents with a
_litedown.yml, including websites for R packages viapkg_site().Workflow:
roam()previews and renders documents in a browser, with live reload, so you do not need aKnitbutton.
Installation
install.packages('litedown')The development version is available from r-universe:
install.packages('litedown', repos = 'https://yihui.r-universe.dev')A quick look
Save this as hello.Rmd:
---
title: Hello litedown
output: html
---
```{r}
x = 2
```
The area of a circle with radius `{r} x` is `{r} pi * x^2`.Then render it:
litedown::fuse('hello.Rmd') # hello.Rmd -> hello.html
litedown::roam() # or preview and render in a browserMain functions
| Function | What it does |
|---|---|
fuse() | executes code in an R Markdown document, then renders it via mark() (like rmarkdown::render()) |
mark() | renders Markdown to HTML, LaTeX, etc. (like Pandoc) |
fiss() | extracts code from a document (like knitr::purl()) |
roam() | previews and renders documents in a browser |
fuse_book(), fuse_site(), pkg_site() | build books, websites, and package sites |
If you do not compute in your documents, mark() alone is enough.
Learn more
Visit the package site, https://pkg.yihui.org/litedown/, which has the manual, the book litedown: R Markdown Reimagined, and examples.
Scope
I try to keep the R package small, and most planned features have been (re-)implemented so far, such as reports, slides, books, websites (including package sites), and paged HTML documents, etc. See the set $R$ below:
$$\mathrm{litedown} = \min{{R}} + {D_i} - {D_e} + {J}$$
$R$ = knitr + evaluate + rmarkdown + bookdown + blogdown + pagedown + pkgdown + xaringan + tufte + distill + htmlwidgets
$D_i$ = (internal dependencies) xfun
$D_e$ = (external dependencies) Pandoc + Bootstrap + jQuery + GitBook + Hugo + paged.js + remark.js + tufte.css + distill.js/.css + ...
$J$ = Lightweight vanilla JavaScript/CSS
Much of the functionality lives in CSS/JS, which makes litedown highly extensible and customizable: see Chapter 5 of the book for how to use the default assets and write your own. You are welcome to write your own CSS/JS, or contribute yours to lite.js so that everyone can use it.
Feature requests are welcome, too. I will take votes into consideration, so please upvote the features you like.
Acknowledgments
litedown was directly inspired by the packages in the set $R$ above. I wrote or co-wrote most of them, and learned a lot from the rest. Thanks to all their authors and contributors, and to the users whose questions, bug reports, and feedback over the years shaped the design of this package.
License
The litedown package is licensed under MIT.