roxygen2md (version 1.0.1)

markdownify: Convert text to Markdown

Description

Converts a character vector from Rd to Markdown.

The scope argument controls the depth of the transformation.

With scope = "none", no transformations are carried out. The only effect is that Markdown is enabled for this package.

With scope = "simple", the following elements are converted:

• \\code{}

• \\emph{}

• \\bold{} and \\strong{}

• \\href{}

• \\url{}

With scope = "full", the following elements are converted in addition:

• \\code{\link{}} and \\link{}, with [] options

• \\linkS4class{}

With scope = "unlink", only the following elements are translated:

• \\link{...} to ...

With scope = "indent", @param and @return tags spanning multiple lines are indented with two spaces.

Usage

markdownify(text, scope = c("full", "simple", "unlink", "indent", "none"))

Value

The same vector with .Rd style annotations converted to Markdown style annotations.

Arguments

text

A character vector containing .Rd style annotations.

scope

The scope of transformations: "simple" runs only transformations that shouldn't substantially change the resulting .Rd files, "full" runs all transformations. In larger packages, run "none", double-check and track the changes, and then run "simple" and then "full".

Examples

text <- c(
  "Both \\emph{italics} and \\bold{bold} text.",
  paste0("We can also convert code: \\", "code{\\", "link{identity}}.")
)

text
markdownify(text)