Yihui Xie

Thanks, TJ Mahr, for Reading the Pandoc Documentation!

Yihui Xie / 2017-11-20


TJ Mahr happily discovered that he got 500 reputation points on StackOverflow today. I awarded him for reading the Pandoc documentation and posting an answer to an R Markdown question there.

I have encouraged R Markdown users to read Pandoc’s documentation on the Markdown syntax (at least once) in both the bookdown book and the blogdown book. Yes, Pandoc’s documentation is lengthy, but I think it is worth the time. Sadly, some users (for example) don’t even read my significantly simplified version of the Pandoc documentation.

TJ’s answer was quite simple, but it was worth 500 points because it saved me a little bit patience. When you have to repeat something several times to different users, it is easy to lose patience. Even though I think I’m pretty good at controlling my temper online now, it is still good to see that someone else has read Pandoc’s documentation and pointed out the correct solution in the documentation before I have to do so.

The documentation can save you. It is not that bad.