Hugodown

Overview:

hugodown is an experimental package that aims to facilitate the use of RMarkdown and hugo together for creating Hugo websites. It is similar to blogdown but focuses purely on Hugo websites and enforces stricter partitioning of roles between hugodown and hugo. It transforms .Rmd files to .md files, and then hugo transforms .md files to .html files.

Features:

• Selective R code execution: hugodown only re-runs your R code when you explicitly ask for it by knitting the post. This makes it easier to use for long-running blogs with multiple contributors.
• Pinned local previews: Local previews are pinned to a specific version of hugo. This makes it easier to work with multiple blogs and protects you from hugo <-> theme version incompatibilities.
• Theme support: hugodown provides support for getting started with a limited number of themes and automatically makes needed tweaks to ensure that html widgets, syntax highlighting, and math display work out of the box.
• Limited cross-references support: hugodown does not currently support within page cross-references for figures, tables, and equations.
• Opinionated hugo configuration: hugodown is more opinionated about hugo configuration, refer to the config vignette for more details.
• Single Rmarkdown format: hugodown is designed around a single Rmarkdown format, .Rmd.

Summary: