https://github.com/yihui/litedown

A lightweight version of R Markdown
https://github.com/yihui/litedown

litedown markdown r r-markdown r-package report-generator reproducible-research

Last synced: 12 days ago
JSON representation

A lightweight version of R Markdown

• Host: GitHub
• URL: https://github.com/yihui/litedown
• Owner: yihui
• License: other
• Created: 2024-03-12T05:38:30.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-10-25T04:26:16.000Z (17 days ago)
• Last Synced: 2024-10-26T08:57:06.660Z (15 days ago)
• Topics: litedown, markdown, r, r-markdown, r-package, report-generator, reproducible-research
• Language: R
• Homepage: https://yihui.org/litedown/
• Size: 538 KB
• Stars: 169
• Watchers: 7
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - yihui/litedown - A lightweight version of R Markdown (R)

README

        
```         

  ______  

 /   ⚡  \

/litedown\

\   ⚡    /

 \______/

```

# R Markdown Reimagined

[![R-CMD-check](https://github.com/yihui/litedown/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/yihui/litedown/actions/workflows/R-CMD-check.yaml)

[![CRAN

release](https://www.r-pkg.org/badges/version/litedown)](https://cran.r-project.org/package=litedown)

[![litedown on

r-universe](https://yihui.r-universe.dev/badges/litedown)](https://yihui.r-universe.dev/litedown)

This package provides a trimmed-down and reimagined implementation of [R

Markdown](https://rmarkdown.rstudio.com). It is much more lightweight, at the

price of dropping some features. It does not depend on the R package **knitr**

or the system package Pandoc.

Please consider this package experimental for now. The documentation is also

very incomplete and still under development.

## Usage

### Installation

At the moment, you are recommended to install the development version from

r-universe:

``` r

install.packages('litedown', repos = c('https://yihui.r-universe.dev', 'https://cloud.r-project.org'))

```

### Markdown rendering

The function `litedown::mark()` is based on the R package

[**commonmark**](https://github.com/r-lib/commonmark), and renders Markdown to

various output formats supported by **commonmark**, which are primarily HTML and

LaTeX. MS Office formats are not supported.

### Knitting

R Markdown documents need to be knitted to Markdown before being rendered to a

target output format. The function `litedown::fuse()` plays a role similar to

`knitr::knit()` and `rmarkdown::render()`. It fuses program code with

narratives, i.e., it executes code in the source document and interweaves

results with narratives in the output document.

### Previewing

Try `litedown::roam()`.

## Scope

We want to limit the scope of this package. Most planned features have been

implemented so far. Please feel free to file feature requests anyway, but we may

be a little conservative when considering them (we will take votes into

consideration, so please upvote features you like).

## License

The **litedown** package is licensed under MIT.