class: center, middle, inverse, title-slide # First Steps in Markdown ### Prof. Dr. Jan Kirenz ### HdM Stuttgart ### 2019/07/24 (updated: 2019-08-25) --- layout: true <div class="my-header"></div> <div class="my-footer"><span> First Steps in Markdown                             Prof. Dr. Jan Kirenz </span></div> --- class: left, middle background-image: url(https://raw.githubusercontent.com/dcurtis/markdown-mark/master/png/208x128-solid.png) background-position: 80% 10% # First Steps in Markdown - Markdown is one of the world’s most popular markup languages -- - Created by John Gruber in 2004 -- - Not a WYSIWYG editor like MS Word where changes are visible immediately -- - Markdown can be rendered (i.e. converted) to many output formats (HTML, PDF, Word,...) -- - Sites like GitHub and Stack Overflow use variants of Markdown --- class: left, middle # First Steps in Markdown - You can add Markdown formatting elements to a plaintext file using a text editor application  ---  Text can be added to [Jupyter Notebooks](https://jupyter.org/index.html) using **Markdown** cells. ---  **RStudio** uses [R Markdown](https://rmarkdown.rstudio.com) which supports static and dynamic output formats including HTML, PDF, MS Word, HTML5 slides, books, dashboards, websites and more. --- class: center, middle <iframe src="https://player.vimeo.com/video/178485416?color=428bca&title=0&byline=0&portrait=0" width="640" height="400" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe> <p><a href="https://vimeo.com/178485416">What is R Markdown?</a> from <a href="https://vimeo.com/rstudioinc">RStudio, Inc.</a> on <a href="https://vimeo.com">Vimeo</a>.</p> --- class: left, middle background-image: url(https://d33wubrfki0l68.cloudfront.net/f697f7a6fd126e0ad928d41bdbd28996c54ee108/5ed53/lesson-images/cheatsheets-3-quick-reference.png) background-position: center background-size: contain # Open RStudio Go to **File** > **Help** > **Markdown Quick** **Reference** to open the Markdown Quick Reference in your help pane. To learn more, visit the site [R Markdown](https://rmarkdown.rstudio.com) --- # Learn Markdown - Excellent [Markdown guide](https://www.markdownguide.org) from Matt Cone - [R Markdown Reference guide](https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf) - [R Markdown Cheatsheet](https://www.rstudio.com/resources/cheatsheets/#rmarkdown) from RStudio - [Jupyter Notebook Markdown Guide](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html) - [GitHub Markdown](https://guides.github.com/features/mastering-markdown/) guide - [Stack Overflow Markdown](https://stackoverflow.com/editing-help) guide - Detailed [Markdown documentation](https://daringfireball.net/projects/markdown/syntax) from John Gruber --- # Markdown Editors - If you only need a Markdown editor, I recommend [Visual Studio Code](https://code.visualstudio.com/docs/languages/markdown). - [Dillinger](https://dillinger.io) is a cloud-enabled, mobile-ready, offline-storage Markdown editor. - For data science projects in **R** or **SQL**, the [RStudio IDE](https://rmarkdown.rstudio.com) is an excellent choice with great documentation and many static and dynamic output options. - If you work with **Python**, I recommend to use [Jupyter Notebook](https://jupyter.readthedocs.io/en/latest/install.html) inside the [Anaconda distribution](https://www.anaconda.com/distribution/). Anaconda conveniently installs Python, the Jupyter Notebook, and other commonly used packages for scientific computing and data science. --- class: center, middle # Thank You! [Prof. Dr. Jan Kirenz]((https://www.kirenz.com) HdM Stuttgart Nobelstraße 10 70569 Stuttgart 