Convert elements of roxygen documentation to markdown
Switch branches/tags
Clone or download
Latest commit 679219e Jul 31, 2018
Failed to load latest commit information.
inst/rstudio RStudio add-in Nov 24, 2016
man transform_test() -> markdownify() Jul 30, 2018
.Rbuildignore add API Feb 3, 2017
.gitignore infra Nov 16, 2016
API transform_test() -> markdownify() Jul 30, 2018
DESCRIPTION fledge: Bump version to Jul 30, 2018
NAMESPACE transform_test() -> markdownify() Jul 30, 2018 fledge: Bump version to Jul 30, 2018 Update github install repo org Jul 26, 2018
roxygen2md.Rproj infra Nov 16, 2016


The goal of roxygen2md is to replace Rd syntax with Markdown in your package's roxygen2 documentation. Currently, the following substitutions are carried out:

  • \code{\link{...}} becomes [...()]
  • \code{\link[...]{...}} becomes [...::...()]
  • \code{...} becomes `...`

If necessary, DESCRIPTION is edited to enable Markdown in roxygen blocks. You'll need roxygen2 version 6.0.0 or later.

Call roxygen2md::roxygen2md() in your package's directory, or navigate to "Tools/Addins/Rd to Markdown" in RStudio.

More to come. The substitutions are not completely safe, please carefully examine the results!

Let me know if this works with your documentation.


Install from GitHub using

# install.packages("roxygen2")
# install.packages("remotes")


In your package directory, run


If you are using RStudio, simply choose the item "Rd to Markdown" from your "Addins" menu.

GPL-3 © Kirill Müller