outline/toc on the left and contents on the right layout using rmarkdown
<p>I was checking out how to include a nice table of contents / document outline in my <code>rmarkdown</code> document (with html output). </p>

<p>Well, the "standard" approach:</p>

<pre><code>html_document:
    toc: true
</code></pre>

<p>It works, but I do not like it (not even tweaking  options and themes).</p>

<p>But actually, in several pages of the documentation (e.g. <a href="http://rmarkdown.rstudio.com/html_document_format.html" rel="nofollow">http://rmarkdown.rstudio.com/html_document_format.html</a>), they use a very nice layout that includes a table of contents / document outline to the left of the page and the contents of the right (and the outline syncs with the contents part, Highlighting where on the contents you currenly are). </p>

<p>This is EXACTLY what I want. And I guess they did it using <code>rmarkdown</code>. But I cannot find how to do it.</p>

<p>I've check that documentation page, as well as <code>rmarkdown</code> <a href="http://rmarkdown.rstudio.com/gallery.html" rel="nofollow">gallery</a>, <a href="http://rmarkdown.rstudio.com/flexdashboard/" rel="nofollow">flex dashboard</a>, <a href="http://rmarkdown.rstudio.com/rmarkdown_websites.html" rel="nofollow">web sites</a> among others. But I can't seem to figure it out how to do it. </p>

<p>Well, using <a href="http://rmarkdown.rstudio.com/rmarkdown_websites.html" rel="nofollow">web sites</a> I would be able to do it, but it seems overly complicated for what I want (you need to have several pages, and at least index.Rmd file and the _site.yml file). </p>

<p>Instead, I guess there should be an option to simply tell <code>rmarkdown</code> to take my single document and put the section headers in a nice frame to the left, as in the example page from RStudio.</p>