Skip to content

Commit 24a30ad

Browse files
Update README.md
1 parent 8f92e4d commit 24a30ad

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -250,6 +250,8 @@ B.F.A. in Music Performance | August 2005 - May 2009
250250

251251
## Troubleshooting
252252

253+
### Pandoc
254+
253255
Most issues that people have using this package are related their installation
254256
Pandoc, software that R Markdown relies on.
255257
Currently Postcards works best with Pandoc version 2.8 or greater, although we
@@ -275,6 +277,21 @@ to use RStudio and
275277
If you are still encountering error messages after trying the above please open
276278
an issue.
277279

280+
### Positron
281+
282+
If you're using the RStudio keybindings in Positron, the Cmd-Shift-K shortcut will issue the `quarto preview` terminal command instead of `rmarkdown::render()` in the R console, and the `index.html` will not be rendered properly with images, links, etc. There are two workarounds to this.
283+
284+
1. Insert the chunk below into your `index.Rmd` and run the line to render with rmarkdown instead of quarto.
285+
````
286+
```{r, eval=FALSE, include=FALSE}
287+
rmarkdown::render("index.Rmd")
288+
```
289+
````
290+
3. Use the "Render Document With R Markdown" button in the preview dropdown menu in Quarto.
291+
292+
<img width="340" height="111" alt="image" src="https://github.com/user-attachments/assets/255ff302-1b9e-435e-bac4-0254eeccb48c" />
293+
294+
278295
## Code of Conduct
279296
280297
Please note that the postcards project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.

0 commit comments

Comments
 (0)