Automatically number sections in RMarkdown

Question

I am trying to create a report in R markdown that has sections ordered

Is there a way get R markdown to generate an ordered list like this?

That will work. I was hoping for a method that generated the numbering automatically. That way if I wanted to go back and add in a section I wouldn't have to change the numbering system. — H.Bananas, Oct 19 '16 at 14:43
I dont get you. You dont need the numbers I added. They are just for illustrative purposes. — Martin Schmelzer, Oct 19 '16 at 16:06
Thanks! That is exactly what I needed. This is my first time using Rmarkdown so sorry if the question was super basic. — H.Bananas, Oct 20 '16 at 14:27

score 119 · Answer 1 · edited Sep 30 '19 at 10:37

119

Add the option number_sections: true to your YAML header:

---
title: "My Report"
output: 
  html_document:
    number_sections: true
---

# Main Section

## 2nd Level

### 3rd Level

And voilá, your sections are numbered:

edited Sep 30 '19 at 10:37

llrs

answered Oct 20 '16 at 14:57

Martin Schmelzer

Is there a way to reference the automatically numbered section from within the markdown? [This question](https://stackoverflow.com/questions/2822089/how-to-link-to-part-of-the-same-document-in-markdown/58539106#58539106) asks how to link to a custom description; I want to get the generated section (or subsection) number. – orrymr Jan 08 '20 at 07:16

1 Answers1