Traditionally there are two main ways to customize R Markdown output formats:
one is to use the options of an existing output format, e.g., set toc: true
for html_document; the other is to define a new output format
function based on
rmarkdown::output_format(), which usually requires you to develop an R package
because that’s the best place to host the function.
The first way can be limited—you can only customize the things that are given to you. The second way gives you complete freedom but is also too advanced, and not everyone wants to develop an R package only for the purpose of a customize R Markdown output format. The two ways are two extremes. Is there a compromise?
Yes, Atusy has made it
possible in rmarkdown 2.24.
With the new function rmarkdown::output_format_dependency(), you can enjoy the
(almost) full freedom of customization without having to develop an R package.
He has kindly written a blog
post
about it, which I’d strongly recommend to R Markdown users who desire deeper
customizability. Thanks, Atusy!
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).