How to specify numbered sections in Pandoc's front matter?

yaml pandoc
tlnagy picture tlnagy · Jun 13, 2014 · Viewed 14k times · Source

I would like to specify numbered sections via Pandoc's support for YAML front matter. I know that the flag for the command-line usage is --number-sections, but something like

---
title: Test
number-sections: true
---

doesn't produce the desired result. I know that I am close because you can do this with the geometry package (e.g. geometry: margin=2cm). I wish there was a definitive guide on how Pandoc YAML front matter handling. For example, the following is very useful (avoids templates), but its discoverability is low:

 header-includes: 
 - \usepackage{some latex package}

Answer

dfc picture dfc · Jun 13, 2014

In order to turn on numbered-sections in latex output you need to use numbersections in your YAML block. If you ever want to "discover" things like this with pandoc just poke around the templates:

 $ grep -i number default.latex
 $if(numbersections)$
 $ grep -i number default.html*
 $

As you can see this option does not work with html.

Markdown and YAML I tested with:

 ---
 title: Test
 numbersections: true
 ---


 # blah

 Text is here.

 ## Double Blah

 Twice the text is here

If you need it to work with more than beamer,latex,context,opendoc you will need to file a bug at github.

Related questions

What can I control with YAML header options in pandoc?

Only by chance did I see an example document using the toc: true line in their YAML header options in a Markdown file to be processed by Pandoc. And the Pandoc docs didn't mention this option to control table of …

Read More
How can I specify pandoc's markdown extensions using a YAML block?

Background Pandoc's markdown lets you specify extensions for how you would like your markdown to be handled: Markdown syntax extensions can be individually enabled or disabled by appending +EXTENSION or -EXTENSION to the format name. So, for example, markdown_strict+…

Read More
pandoc "cannot parse yaml header" when converting md to pdf

I am trying to convert a markdown document to pdf using pandoc, and it was working fine until it just started to show an error: pandoc: Could not parse YAML header: did not find expected alphabetic or numeric character "source" (…

Read More