# Jekyll + pandoc heading identifiers

**URL:** <https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254>\
**Category:** Help\
**Created:** [November 20, 2020, 9:32pm UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254 "2020-11-20T21:32:28Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![aeymxq](https://avatars.discourse-cdn.com/v4/letter/a/ecccb3/32.png) [@aeymxq](https://talk.jekyllrb.com/u/aeymxq)\
**Post date:** [November 20, 2020, 9:32pm UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254/1 "2020-11-20T21:32:28Z")

</div>

hey, i’m trying to get jekyll and pandoc set up to automatically add identifiers to heading tags, so that i can use anchor links, as per [this section](https://pandoc.org/MANUAL.html#extension-auto_identifiers) of the pandoc manual.

however, when i add `- auto_identifiers` to my config.yml, i get a compile error (unknown option) and it doesn’t work out.

any ideas for how to get this working?

---

<div class="post-metadata">

**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\
**Post date:** [November 21, 2020, 5:41am UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254/2 "2020-11-21T05:41:12Z")

</div>

no experience with pandoc, but maybe it is a config error. I would post what is in your config and the output with the error.

---

<div class="post-metadata">

**Author:** ![MichaelCurrin](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/michaelcurrin/32/2340_2.png) [@MichaelCurrin](https://talk.jekyllrb.com/u/MichaelCurrin)\
**Post date:** [November 21, 2020, 8:35pm UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254/3 "2020-11-21T20:35:44Z")

</div>

What you shared is manual for pandoc as a standalone CLI tool, from a quick look.

If you put

```auto
- auto_identifiers

```

In your Jekyll configuration it won’t know about pandoc. And it looks like you get an error because you are creating a list in your config - normally everything in the config has a key like `baseurl: "/foo"`.

Is your plan to run pandoc over your Jekyll files as a separate step? Or did you want to use a Jekyll integration that will handle the headings as links for you?

---

<div class="post-metadata">

**Author:** ![MichaelCurrin](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/michaelcurrin/32/2340_2.png) [@MichaelCurrin](https://talk.jekyllrb.com/u/MichaelCurrin)\
**Post date:** [November 22, 2020, 6:51am UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254/4 "2020-11-22T06:51:46Z")

</div>

I don’t know if you have other pandoc needs but for headings as anchor tags there are solutions here.

> <https://stackoverflow.com/questions/40469259/how-do-i-add-permalinks-to-headers-in-kramdown>

---

<div class="post-metadata">

**Author:** ![MichaelCurrin](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/michaelcurrin/32/2340_2.png) [@MichaelCurrin](https://talk.jekyllrb.com/u/MichaelCurrin)\
**Post date:** [November 22, 2020, 6:54am UTC](https://talk.jekyllrb.com/t/jekyll-pandoc-heading-identifiers/5254/5 "2020-11-22T06:54:12Z")

</div>

This solution covered there should work across your whole site if used in a layout

> **[allejo/jekyll-anchor-headings](https://github.com/allejo/jekyll-anchor-headings#jekyll-pure-liquid-heading-anchors)**
>
> A GitHub Pages compatible way of adding anchors to your headings without a plug-in or JavaScript :octocat: - allejo/jekyll-anchor-headings