Markdown is a plain-text formatting syntax that can be converted to HTML or other formats. This package provides wrappers based on the commonmark package.
The main function mark() renders Markdown to various output formats supported
by commonmark; mark_html() is a wrapper function to render Markdown to
HTML, and mark_latex() is a wrapper function for LaTeX output.
This package supports a series of extra Markdown features that are not in
commonmark, such as LaTeX math, raw HTML/LaTeX blocks, fenced Divs,
heading/image attributes, and footnotes, etc. The Markdown rendering behavior
can be controlled by several options, e.g., whether to enable the table of
contents. It also supports custom HTML/LaTeX templates. To get a full
introduction, please read the intro
vignette.
You may also read the article
vignette
and the slides
vignette to
learn more about possible applications based on this package.
This package is referred to as the first generation (v1) of R Markdown when combined with knitr. The primary output formats are HTML and LaTeX. In 2014, we introduced the second generation (v2) of R Markdown, i.e., the rmarkdown package, which is based on Pandoc and knitr, and supports many more types of output formats.
It is a deliberate design choice to keep this markdown package lightweight, to make it easy to use and simple to maintain. We may be conservative when considering new feature requests. It is definitely not the goal to become a substitute of tools based on Pandoc, such as rmarkdown and Quarto. To some degree, this package is intended for minimalists, and does not aim at rich features.
The markdown package is licensed under MIT.