get-started_1.qmd

---
title: "Tutorial: Hello, Quarto"
---

### Some comments before the tutorial

- The tutorial uses the [Visual Editor](https://quarto.org/docs/visual-editor/) in RStudio. We recommend to frequently switch between *Visual* and *Source* mode (the tutorial will explain how to do that) to see how the raw markdown syntax looks like.

- Remember to put all *.qmd* files you download during the tutorial into the RStudio project directory you have created [earlier](preparations.qmd).

- Skip watching the [video introduction](https://youtu.be/_f3latmOhew) for now (the video is great, but too long for the 2h workshop). 

### Start the tutorial

If you have problems during the tutorial come back **here** and see the next section for our list of anticipated issues.
*After* completing the first tutorial, come back **here** and continue with the next tutorial [on this page](get-started_2.qmd).

:::{.callout-tip}
## Let's start
Now you can start the first tutorial at <https://quarto.org/docs/get-started/hello/rstudio.html>.
:::

### Possible problems and related comments

- If the preview does not automatically open on the right side when you click *Render*, go to the gear wheel next to the *Render* button, select *Preview in Viewer Pane* and then click *Render* again. The other option (which seems to be the default for some people) is *Preview in Window* which displays the rendered document in your default web browser instead of whithin RStudio.

- The tutorial mentions the Markdown syntax (e.g. `**bold**`) used in Quarto but never gives you [this link](https://quarto.org/docs/authoring/markdown-basics.html) where the Pandoc Markdown syntax is described in-depth. 

- The tutorial discusses the `format: html` option in the YAML header and implies that you can also use `format: pdf` or `format: docx`. Indeed the results for these two options will look like this:

  {{< downloadthis _hello.pdf dname="hello" label="Download .pdf file">}}  {{< downloadthis _hello.docx dname="hello" label="Download .docx file">}}