markdown 2.0

• The core function mark() is a thin wrapper of litedown::mark() now. Users are recommended to call litedown directly instead of through the wrapper.

markdown 1.13

• Cleaned sourcepos records when they come from metadata (thanks, @dmurdoch, #111).

• The markdown package is in the maintenance-only mode now. It is feature-complete, and will receive no updates except for fixing CRAN problems. New development will continue only in litedown: https://github.com/yihui/litedown.

markdown 1.12

• Provided three internal functions html_document, html_vignette, and pdf_document as compatibility layers to functions of the same names in the rmarkdown package (thanks, @jangorecki, #108). See the appendix in vignette('intro', package = 'markdown') for details.

• The default HTML template no longer wraps meta variables include-before and include-after inside <div></div>, because their values may contain incomplete HTML tags, e.g., include-before = '<div>' and include-after = '</div>'.

markdown 1.11

• Verbatim code blocks of the form ```{lang attr1 attr2 ...} were not correctly rendered.

markdown 1.10

• Raw blocks (```{=lang}) were broken in the previous version when the support for code block attributes was added.

markdown 1.9

• Added support for attributes on fenced code blocks, e.g., ```{.lang .class2 #id attr="value"} (thanks, @thothal, #106).

• Fixed the bug that the option number_sections: true doesn't work for HTML output when then input contains certain Unicode characters (thanks, @fyuniv, #104).

• Added support for rendering HTML Widgets such as ggplotly (thanks, @fyuniv, #105).

markdown 1.8

• Fixed the superfluous warning about path lengths in mark_html() (thanks, @kenjisato, #103).

markdown 1.7

• The file argument of mark() will be treated as a file path only if the file exists and the value is not wrapped in I(). Previously, it would be treated as a file path when it has a file extension, which could lead to confusing errors like #100 (thanks, @LukasWallrich).

• When there are emojis in the text, mark() may fail to identify and embed web resources (thanks, @tdhock, yihui/knitr#2254).

markdown 1.6

• Added support for footnotes, fenced Divs, section numbers, {} attributes for images/headings/fenced Divs, and appendices. See vignette('intro', package = 'markdown') for details.

• A lot of enhancements to the HTML slides format. See vignette('slides', package = 'markdown') for details.

• Added vignette('article', package = 'markdown') to demonstrate how to write an HTML article.

• If the input to mark() is a file, the output will also be a file by default. Previously the output would be text. If you want mark() to return text output when the input is a file, you may specify the argument output = NULL.

• The Markdown option base64_images has been renamed to embed_resources. This option can take two possible values, "local" and "https", meaning whether to embed local and/or web (https) resources. You can specify none, either, or both of them. See vignette('intro', package = 'markdown') for details.

• Removed the option standalone from the list of Markdown options. Please use the argument template = TRUE/FALSE of mark() instead. The option standalone = TRUE was equivalent to template = TRUE.

• Added the option auto_identifiers (enabled by default) to automatically add IDs to headings, e.g., # Hello world! will be converted to <h1 id="hello-world">Hello world!</h1>. You can certainly override the automatic ID by providing an ID manually via the {#id} attribute, e.g., # Hello world! {#hello}.

• Renamed the mathjax option to js_math to allow for other JS math libraries. The default library was changed from MathJax to KaTeX. To continue using MathJax, you may set js_math: mathjax.

• Removed the option mathjax_embed from the list of Markdown options. To embed the MathJax library, enable "https" in the embed_resources option instead. Note that only MathJax v3 can be partially embedded, and lower versions cannot.

• Renamed the option highlight_code to js_highlight, and added support for an alternative syntax highlighting JS library Prism.js, which became the default. To continue using the old default highlight.js, you may set the js_highlight option to highlight.

• The default version of MathJax has been changed from v2 to v3.

• The default version of highlight.js has been changed from 11.6.0 to 11.7.0, and the default style has been switched from github to xcode.

markdown 1.5

• Values of meta variables title, author, and date (if provided) will be transformed to the target output format before they are passed into templates.

• Fixed the bug that the default CSS was not added to HTML output.

• Removed dependency on the mime package.

• Added experimental support for HTML slides: markdown::mark_html(..., meta = list(css = c('default', 'slides'), js = 'slides')). If you prefer knitting Rmd documents in RStudio, you may use the output format:

  output:
    markdown::html_format:
      meta:
        css: [default, slides]
        js: [slides]

  See https://yihui.org/en/2023/01/minimal-r-markdown/ for a demo.