• R: data, analyses, figures.

• What about Markdown?

  • Wikipedia says: “Markdown is a lightweight markup language with plain text formatting syntax.”

  • https://daringfireball.net/projects/markdown/

Markdown is intended to be as easy-to-read and easy-to-write as is feasible.

html

<a href="https://github.com/KevCaz/aboutRMarkdown">My repo</a>

markdown

[My repo](https://github.com/KevCaz/aboutRMarkdown)

html

<ol>
  <li> items1 </li>
  <li> items2 </li>
  <li> items3 </li>
</ol>

markdown

1. items1
2. items2
3. items3

• GitHub Flavored Markdown (GFM)
• Kramdown
• Markdown Extra
• Multi Markdow
• Pandoc Markdown

https://blog.codinghorror.com/responsible-open-source-code-parenting/

“I despise what you’ve done with Text::Markdown, which is to more or less make it an alias for MultiMarkdown, almost every part of which I disagree with in terms of syntax additions.” (John Gruber, on 15 Mar 2008)

http://commonmark.org/

“A strongly defined, highly compatible specification of Markdow.”

• Static Website generator (jekyll, hugo, …)
• R markdown
• blogdown written using bookdown
• Slack
• Github
• Markdown here
• Markdown here’s awesome markdown cheat sheet

https://rmarkdown.rstudio.com/

https://yihui.name/knitr/

```{R name, options}

your_code

```

• Wikipedia says: “YAML (YAML Ain’t Markup Language) is a human-readable data serialization language.”

author: Bill June
data: 2018-11-03

• metadata of your file

https://pandoc.org/

1. writing .Rmd document
2. Click to obtain your final document (call render())
3. knitr convert code chunk
4. you obtain a .md version
5. this .md file + yaml ==> pandoc

https://cran.r-project.org/web/packages/rmarkdown/

cos(pi)

R>> [1] -1

sin(3)

R>> [1] 0.14112

exp(10)

R>> [1] 22026.47

head(CO2)

R>>   Plant   Type  Treatment conc uptake
R>> 1   Qn1 Quebec nonchilled   95   16.0
R>> 2   Qn1 Quebec nonchilled  175   30.4
R>> 3   Qn1 Quebec nonchilled  250   34.8
R>> 4   Qn1 Quebec nonchilled  350   37.2
R>> 5   Qn1 Quebec nonchilled  500   35.3
R>> 6   Qn1 Quebec nonchilled  675   39.2

knitr::kable(head(CO2))