Markdown: uses for research and teaching

name: title
class: Left, middle
background-image: url(images/rawpixel/nasa-europe-drakside.jpg)
background-size: cover

# .whiteinline[.fancy[Markdown: uses for research and teaching]]

### .whiteinline[[3.1] Literate programming y markdown]

.whiteinline[Reproducible Research Practices (RRP'21) &#183; April 2021]

.right[.whiteinline[Carlos Granell &#183; Sergi Trilles]]

.right[.whiteinline[Universitat Jaume I]]

???

Image of Europe, Africa, and the Middle East at night. Original from NASA. Digitally enhanced by rawpixel.
Source: [Rawpixel](https://www.rawpixel.com/image/418610/earth-dark-side)

---
name: spacecraft
class: bottom, middle
background-image: url(images/rawpixel/nasa-cygnus-spacecraft.jpg)
background-size: cover

---
template: spacecraft

## Why focus on the process when the world is outcome driven? Don’t results matter?

---
template: spacecraft

## Yes, results do matter.

---
template: spacecraft

### But if you optimize for the outcome, you win one time.

### If you optimize for .acidinline[a process that leads to great outcomes], you can win again and again.

---
class: center
# Do you use...

### ...word processor tools for writing papers?

### ...presentation tools for making your slides?

### ...notes tools for taking your research notes?

### ...web editor tools for making your web site?

---
class: center, middle

## How many distinct tools do you use to create/write .acid[content?]

---
class: bottom, center
background-image: url(images/rmarkdown_hedgehog.png)
background-size: 25%
background-position: 50% 20%

# It's all about .acidinline[Markdown] <a name=cite-xie2018></a>[[XAG18](https://bookdown.org/yihui/rmarkdown/)]

---
background-image: url(images/rmarkdown_hedgehog_wide.png)
background-size: contain
background-position: middle, center

???
Source: [Teaching in Production](https://rstudio-education.github.io/teaching-in-production/)

---
class: center, middle

# Really?

.large[Yes - Open [demo_1doc_Nformats.md](https://rstudio.cloud/project/2482163)]

---
class: inverse, center, middle

# What does Markdown mean for your research?

---
class: center
background-image: url("images/rmd_flowchart.png")
background-size: contain
background-color: #f6f6f6

???
Source: [Teaching in Production](https://rstudio-education.github.io/teaching-in-production/)

---
class: center

### Open, plain format, multiple output formats

### Versioning (Github)

### Notes, planning, exploratory ideas, documentation (README files), etc.

### Technical reports, papers, books, etc.

### Result communications, presentations, etc.

### Dashboards, web sites, blog sites, etc.

---
class: inverse, center, middle

# What does Markdown mean for your teaching?

---
class: center
background-image: url("images/rmd_flowchart.png")
background-size: contain
background-color: #f6f6f6

???
Source: [Teaching in Production](https://rstudio-education.github.io/teaching-in-production/)

---
class: center

### Open, plain format, multiple output formats

### Versioning (Github)

### Notes, planning, exploratory ideas, documentation (README files), etc.

### Syllabus, e-portfolio, etc.

### Hands-on exercises, lessons summaries, essays, etc.

### Presentations, web sites, blog sites, etc.

.acid[and your students delivering all of the above]

---

# References

<a name=bib-xie2018></a>[Xie, Y, JJ Allaire, et al.](#cite-xie2018)
(2018). _R markdown: The definitive guide_. CRC Press. URL:
[https://bookdown.org/yihui/rmarkdown/](https://bookdown.org/yihui/rmarkdown/).