4 ms·

Pandoc is one of my favourite all time tools. As the website says: > If you need to convert files from one markup format into another, pandoc is your swiss-ar

Pandoc is one of my favourite all time tools. As the website says: > If you need to convert files from one markup format into another, pandoc is your swiss-army knife It also sits at the heart of Quarto[0], which adds Jupyter-like code execution (in R, Python and others) into document production. Combined with RStudio as an IDE, it's my new favourite way to write anything - from static documents to full on code notebooks. No affiliation with Posit, the company behind Quarto & RStudio. Just a happy user. -- [0]: https://quarto.org/ https://quarto.org/ [1]: https://posit.co/products/open-source/rstudio/ https://posit.co/products/open-source/rstudio/

banga 3y ago
Codebraid[0] is another option for integrating code execution with Pandoc. I find myself using Quarto for building sites and Codebraid more for single documents. Both great tools building on Pandoc. -- [0]: https://codebraid.org/ https://codebraid.org/
- nerdponx 3y ago
  Why do all these tools pretend that knitr / R Markdown never existed, and that they have invented some novel concept? I looked through the docs of Quarto, Jupytext, and now Codebraid, and none of them mention prior art. There's a long legacy here, it does nobody any good to disregard it. Maybe Knuth is well-acknowledged for his invention, but I think for instance Yihui Xie is a little under-recognized.
  - 2cynykyl 3y ago
    From what I can tell, Quarto is essentially an installer for Knitr/R, that also comes with a bunch of goodies, like when working in VSC (or Rstudio) it auto-suggests cross-references to content in the document, like figures/chapters/equations/etc. It also has a github action that builds and deploys the site in like 1 one line. Just removing the friction and lowering the bar is very helpful sometimes.
    - hadley 3y ago
      That's true, but quarto also has full support for Python and Jupyter notebooks, not to mention julia, and observable. It's really built from the ground up to be multi-language so that everyone can benefit from all the goodies in RMarkdown.
  - hadley 3y ago
    Is there some way we could advertise this better? The quarto homepage already says “Quarto is a multi-language, next generation version of R Markdown from Posit, with many new new features and capabilities.” When talking about Quarto within the R community we usually frame it this way, but obviously it’s not a very useful description if you’ve never heard of RMarkdown.
    - nerdponx 3y ago
      If that's how you frame it, then I stand corrected and I apologize for my incorrect criticism.
  - pmags 3y ago
    And knitr is built on the prior art foundations of Sweave....
    - hadley 3y ago
      And sweave is built on noweb :)
      - pmags 3y ago
        ...which was based on CWEB/WEB and so on... ;-) Though I guess we can stop there in this particular case, unless someone knows of an example of literate programming that precedes Knuth. I'd be interested if there are such examples...
datadrivenangel 3y ago
Quarto is amazing for creating reports and programmatic slide decks!

banga 3y ago

Codebraid[0] is another option for integrating code execution with Pandoc. I find myself using Quarto for building sites and Codebraid more for single documents. Both great tools building on Pandoc. -- [0]: https://codebraid.org/ https://codebraid.org/

nerdponx 3y ago
Why do all these tools pretend that knitr / R Markdown never existed, and that they have invented some novel concept? I looked through the docs of Quarto, Jupytext, and now Codebraid, and none of them mention prior art. There's a long legacy here, it does nobody any good to disregard it. Maybe Knuth is well-acknowledged for his invention, but I think for instance Yihui Xie is a little under-recognized.
- 2cynykyl 3y ago
  From what I can tell, Quarto is essentially an installer for Knitr/R, that also comes with a bunch of goodies, like when working in VSC (or Rstudio) it auto-suggests cross-references to content in the document, like figures/chapters/equations/etc. It also has a github action that builds and deploys the site in like 1 one line. Just removing the friction and lowering the bar is very helpful sometimes.
  - hadley 3y ago
    That's true, but quarto also has full support for Python and Jupyter notebooks, not to mention julia, and observable. It's really built from the ground up to be multi-language so that everyone can benefit from all the goodies in RMarkdown.
- hadley 3y ago
  Is there some way we could advertise this better? The quarto homepage already says “Quarto is a multi-language, next generation version of R Markdown from Posit, with many new new features and capabilities.” When talking about Quarto within the R community we usually frame it this way, but obviously it’s not a very useful description if you’ve never heard of RMarkdown.
  - nerdponx 3y ago
    If that's how you frame it, then I stand corrected and I apologize for my incorrect criticism.
- pmags 3y ago
  And knitr is built on the prior art foundations of Sweave....
  - hadley 3y ago
    And sweave is built on noweb :)
    - pmags 3y ago
      ...which was based on CWEB/WEB and so on... ;-) Though I guess we can stop there in this particular case, unless someone knows of an example of literate programming that precedes Knuth. I'd be interested if there are such examples...

datadrivenangel 3y ago

Quarto is amazing for creating reports and programmatic slide decks!