r - How to change the position of the table of contents in rmarkdown?

Question

With RStudio and knitr I see that I can add a TOC with the following code in my .rmd file.

----------------
output: 
  html_document:
    toc: yes
-----------------

However, this places the TOC at the very beginning of the HTML document. Is there a way to move the TOC lower on the page? Say after an introductory paragraph?

I tried to use __TOC__ and __FORCETOC__ but it did not change the TOC position.

Answer 1

The position of the TOC is fixed in the R Markdown default HTML template. If you want to change its position in the document, you'll need to modify the template:

1. Make a copy of the R Markdown HTML template to use as a starting point. You can find it by running this R command: system.file("rmd/h/default.html", package="rmarkdown")
2. Move the $toc section to where you want the table of contents to appear.
3. Save the modified template in the same folder as the document you're rendering as e.g. lowertitle.html
4. Add template: lowertitle.html to the html_document settings.

From the standpoint of the template, all of the document's content is an atomic unit, so it might be necessary to put any content you want to appear before the TOC in the template itself.