- Update on 2018-06-13
-
Half a year has passed, and I think the R Markdown ecosystem should be ready for Pandoc 2.x now. See this post for details.
Pandoc 2.0 was released two weeks ago. I have read its release notes a few times, and my conclusion is that for R Markdown users, there is no need to upgrade to Pandoc 2.0 from 1.x. I don’t see any major benefits relevant to R Markdown. In fact, I’d encourage you to stay with Pandoc 1.19.x for now.
There are a few things that I don’t like about Pandoc 2.0. I feel that the rules for nested lists are quite confusing after the four-space rule was disabled by default in Pandoc 2.0. It took me a while to understand the new rules. I’m not comfortable with the changes in syntax highlighting, either.
There have been a few breaking changes (which are expected, because of the major version number has been increased), which I had to deal with in the rmarkdown package as well as other R Markdown extension packages. The good news is that these changes are not too bad, and the current development versions of rmarkdown, bookdown, and flexdashboard should be compatible with Pandoc 2.0.2 now.
From what I can tell, users often upgraded to Pandoc 2.0 through Homebrew on macOS unconsciously (via brew upgrade), and they do not know an important fact: the RStudio IDE actually bundles Pandoc v1.19.2.1, so there is no need to install Pandoc separately if you use RStudio. If you want to use RStudio’s Pandoc, you can remove the Homebrew versions:
brew remove pandoc pandoc-citeproc
If you want RStudio’s Pandoc to be available system-wide, you can add its path to the system environment variable PATH. The path can be found in the environment variable in RStudio:
Sys.getenv('RSTUDIO_PANDOC')
On macOS, it should be /Applications/RStudio.app/Contents/MacOS/pandoc, so you can export it in ~/.bash_profile, e.g.,
export PATH="$PATH:/Applications/RStudio.app/Contents/MacOS/pandoc"
Anyway, if you must use Pandoc 2.0, try the development versions of these R packages (we will release them to CRAN soon), but personally I just don’t see any major benefits of upgrading to Pandoc 2.0.
Donate
As a freelancer (currently working as a contractor) and a dad of three kids, I truly appreciate your donation to support my writing and open-source software development! Your contribution helps me cope with financial uncertainty better, so I can spend more time on producing high-quality content and software. You can make a donation through methods below.
-
Venmo:
@yihui_xie, or Zelle:xie@yihui.name -
Paypal
-
If you have a Paypal account, you can follow the link https://paypal.me/YihuiXie or find me on Paypal via my email
xie@yihui.name. Please choose the payment type as “Family and Friends” (instead of “Goods and Services”) to avoid extra fees. -
If you don’t have Paypal, you may donate through this link via your debit or credit card. Paypal will charge a fee on my side.
-
-
Other ways:
WeChat Pay (微信支付：谢益辉) Alipay (支付宝：谢益辉) 
When sending money, please be sure to add a note “gift” or “donation” if possible, so it won’t be treated as my taxable income but a genuine gift. Needless to say, donation is completely voluntary and I appreciate any amount you can give.
Please feel free to email me if you prefer a different way to give. Thank you very much!
I’ll give back a significant portion of the donations to the open-source community and charities. For the record, I received about $30,000 in total (before tax) in 2024-25, and gave back about $15,000 (after tax).