# markdownExtensions: Markdown extensions In markdown: Render Markdown with the C Library 'Sundown'

## Description

markdownExtensions returns a character vector listing all the extensions that are available in the markdown package.

## Usage

 1 markdownExtensions() 

## Details

They are all ON by default.

The Sundown library (upon which markdown is built) has optional support for several extensions described below. To turn these on globally in the markdown package, simply place some or all of them in a character vector and assign to the global option markdown.extensions like so:

options(markdown.extensions = markdownExtensions())

To override the global option, pass the extensions as an argument to one of the render functions, e.g.:

markdownToHTML(..., extensions = c('no_intra_emphasis'))

Description of all extensions:

'no_intra_emphasis'

skip markdown embedded in words.

'tables'

create HTML tables (see Examples).

'fenced_code'

treat text as verbatim when surrounded with begin and ending lines with three ~ or ' characters.

'autolink'

create HTML links from urls and email addresses.

'strikethrough'

create strikethroughs by surrounding text with ~~.

'lax_spacing'

allow HTML tags inside paragraphs without being surrounded by newlines.

'space_headers'

add a space between header hashes and the header itself.

'superscript'

translate ^ and subsequent text into HTML superscript.

'latex_math'

transforms all math equations into syntactically correct MathJax equations.

See the EXAMPLES section to see the output of each extension turned on or off.

## Value

A character vector listing all available extensions.

markdownHTMLOptions

## Examples

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 # List all available extensions: markdownExtensions() # To turn on all markdown extensions globally: options(markdown.extensions = markdownExtensions()) # To turn off all markdown extensions globally: options(markdown.extensions = NULL) # The following examples are short, so we set the HTML option 'fragment_only' options(markdown.HTML.options = "fragment_only") # no_intra_emphasis example cat(markdownToHTML(text = "foo_bar_function", extensions = c())) cat(markdownToHTML(text = "foo_bar_function", extensions = c("no_intra_emphasis"))) # tables example (need 4 spaces at beginning of line here) cat(markdownToHTML(text = " First Header | Second Header ------------- | ------------- Content Cell | Content Cell Content Cell | Content Cell ", extensions = c())) # but not here cat(markdownToHTML(text = " First Header | Second Header ------------- | ------------- Content Cell | Content Cell Content Cell | Content Cell ", extensions = c("tables"))) # fenced_code example (need at least three leading ~ or ) fenced_block <- function(text, x = "", n = 3) { fence <- paste(rep(x, n), collapse = "") paste(fence, text, fence, sep = "") } cat(markdownToHTML(text = fenced_block(" preformatted text here without having to indent first line. "), extensions = c())) cat(markdownToHTML(text = fenced_block(" preformatted text here without having to indent first line. "), extensions = c("fenced_code"))) # autolink example cat(markdownToHTML(text = "https://www.r-project.org/", extensions = c())) cat(markdownToHTML(text = "https://www.r-project.org/", extensions = c("autolink"))) # strikethrough example cat(markdownToHTML(text = "~~awesome~~", extensions = c())) cat(markdownToHTML(text = "~~awesome~~", extensions = c("strikethrough"))) # lax_spacing cat(markdownToHTML(text = " Embedding html without surrounding with empty newline.
_markdown_
extra text. ", extensions = c(""))) cat(markdownToHTML(text = " Embedding html without surrounding with empty newline.
_markdown_
extra text. ", extensions = c("lax_spacing"))) # space_headers example cat(markdownToHTML(text = "#A Header\neven though there is no space between # and A", extensions = c(""))) cat(markdownToHTML(text = "#Not A Header\nbecause there is no space between # and N", extensions = c("space_headers"))) # superscript example cat(markdownToHTML(text = "2^10", extensions = c())) cat(markdownToHTML(text = "2^10", extensions = c("superscript"))) 

### Example output

[1] "no_intra_emphasis" "tables"            "fenced_code"
[4] "autolink"          "strikethrough"     "lax_spacing"
[7] "space_headers"     "superscript"       "latex_math"
<p>foo<em>bar</em>function</p>
<p>foo_bar_function</p>
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell
</code></pre>
<tr>
</tr>
<tr>
<td>Content Cell</td>
<td>Content Cell</td>
</tr>
<tr>
<td>Content Cell</td>
<td>Content Cell</td>
</tr>
</tbody></table>
<p><code>
preformatted text here without having to indent
first line.
</code></p>
<pre><code>preformatted text here without having to indent
first line.
</code></pre>
<p>https://www.r-project.org/</p>
<p><a href="https://www.r-project.org/">https://www.r-project.org/</a></p>
<p>~~awesome~~</p>
<p><del>awesome</del></p>
<p>Embedding html without surrounding with empty newline.
<div><em>markdown</em></div>
extra text.</p>
<p>Embedding html without surrounding with empty newline.</p>

<div>_markdown_</div>

<p>extra text.</p>