# Insert table of content in markdown

**URL:** <https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633>\
**Category:** support\
**Created:** [July 6, 2016, 10:29pm UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633 "2016-07-06T22:29:27Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![banyanvines](https://avatars.discourse-cdn.com/v4/letter/b/96bed5/32.png) [@banyanvines](https://discourse.gohugo.io/u/banyanvines)\
**Post date:** [July 6, 2016, 10:29pm UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633/1 "2016-07-06T22:29:27Z")

</div>

How do I insert table of content in the document using markdown syntax? Ideally it should be anywhere in the document and not just top.

---

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [July 6, 2016, 10:31pm UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633/2 "2016-07-06T22:31:59Z")

</div>

It is not possible.

---

<div class="post-metadata">

**Author:** ![kakawait](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/kakawait/32/1330_2.png) [@kakawait](https://discourse.gohugo.io/u/kakawait)\
**Post date:** [July 17, 2016, 12:07pm UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633/3 "2016-07-17T12:07:29Z")

</div>

Tricky workaround

```auto
{{ (replaceRE "<!--\\s*[t|T][o|O][c|C]\\s*-->" .TableOfContents .Content) | safeHTML }}

```

That replace `<!-- toc -->` by corresponding table of contents (works similar as `<!-- more -->`)

---

<div class="post-metadata">

**Author:** ![maiki](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/maiki/32/16384_2.png) [@maiki](https://discourse.gohugo.io/u/maiki)\
**Post date:** [January 27, 2019, 3:16am UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633/4 "2019-01-27T03:16:09Z")

</div>

A post was split to a new topic: [How do I add a TOC to my site?](https://discourse.gohugo.io/t/how-do-i-add-a-toc-to-my-site/16669)

---

<div class="post-metadata">

**Author:** ![maiki](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/maiki/32/16384_2.png) [@maiki](https://discourse.gohugo.io/u/maiki)\
**Post date:** [January 27, 2019, 3:16am UTC](https://discourse.gohugo.io/t/insert-table-of-content-in-markdown/3633/5 "2019-01-27T03:16:21Z")

</div>