> For the complete documentation index, see [llms.txt](https://docs.kyso.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyso.io/guides/posting-r-markdown-to-kyso.md).

# R Users & R Markdown

When posting R markdown (`.rmd`, or `.Rmd` files) to Kyso you will need to convert them to normal markdown (`.md`) files before they hit Kyso. That can be before you upload them, or before you commit them to your Github repository. 

When you convert Rmd to normal markdown it will create run the code in the Rmd file, generate any images and tables needed, create a markdown file and an assets folder for any image files. You can them upload the markdown and assts folder to Kyso.

## Converting R to other formats

### Installing knitr

Knitr is the package that we will use to convert the Rmd files to markdown in order to upload to Kyso, lets install it first using inside your R console:

```
install.packages("knitr")
```

### Using the command line

In the directory of your .Rmd file just use the following command:

```
Rscript -e "library(knitr); knit('notebook.Rmd', 'notebook.md')"
```

### Using R Studio

Make sure you set the working directory to the location of your .Rmd files. 

![R Studio Interface](/files/-Lq0LHyNzHA0ugLpx9zk)

Once you have your working directory set go to your R console inside R studio and enter the following commands, first to load knitr and then to convert the notebook:

```
library(knitr)
knit('notebook.Rmd', 'notebook.md')
```

![Compiling R markdown to markdown](/files/-Lq0LrqnRxGAwSclvRiQ)

{% hint style="info" %}
When publishing to Kyso, be sure to select the generated .md file as the main file, not the .Rmd
{% endhint %}

## Compiling R to HTML

Kyso now also supports HTML! This means R users are also able to compile their scripts to HTML. This will benefit those who like to work with interactive graphing libraries like plotly and bokeh.

Using the above example:

```
library(knitr)
knit('notebook.Rmd', 'notebook.html')
```

And then follow the link below to learn how to ensure a successful upload of HTML to Kyso:

{% content-ref url="/pages/qRkNxsUCIee3Clo06K1T" %}
[HTML](/kysos-renderer/html.md)
{% endcontent-ref %}