Help eliminate a recurring operator error with underscore characters in chunk names?

[dhduncan]

I just got caught up in the ol' underscore-character-in-chunk-name trap with my first foray into proper cross-referencing in a Rmarkdown document rendering to html via bookdown. I see that it's regular error that users encounter:

Related to #892, #839, #157, #941, #867, #406, #194 and #336

Originally posted by @cderv in https://github.com/rstudio/bookdown/issues/1167#issuecomment-858772402

Can I suggest that the warning posted here: https://bookdown.org/yihui/bookdown/figures.html be repeated elsewhere, like:

• in the bookdown documentation where those who think they are familiar with Rmarkdown might find it - like the cross-referencing sections?
• in something like the Rmarkdown cheat sheet as really sound advice for people starting to use Rmarkdown?

[djvill]

Ditto the tables section!