DEV Community

Boris Jamot ✊ /
Boris Jamot ✊ /

Posted on • Updated on

How to Manage the TOC of Articles on

I know there is no current standard in Markdown to write Table Of Content, but does anyone knows a trick to do it on
Could it work by using HTML anchors?
But how can I know the future URL of the article I'm currently writing?

Any help would be welcome :)

Top comments (7)

rhymes profile image

You can use inline anchors with Markdown:

## TOC
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)

### Chapter 1 <a name="chapter-1"></a>
Enter fullscreen mode Exit fullscreen mode

This way you don't need to know the final URL

shostarsson profile image
Rémi Lavedrine

Thanks for the question and the answer.
I didn't know that trick and I am going to try it in my next post.

helenanders26 profile image
Helen Anderson

Thank you! This is just what I’ve been looking for.

bennycode profile image
Benny Code

The Editor Guide is also a nice resource to find out what's possible on

Thread Thread
iamtodor profile image

I faced the issue when does not rended a few levels of table of content:

- [first](#first)
  * [second](#second)
    + [third](#third)

## first

first blah

### second 

second blah 

#### third

third blah
Enter fullscreen mode Exit fullscreen mode

While markdown is rendering it as three level of content renders it only as two. What is the best way to tackle this problem?

Image description

Thread Thread
sfiquet profile image
Sylvie Fiquet

I managed to get a third level by using a 5 space indent:

- level 1
  - level 2
     - level 3
Enter fullscreen mode Exit fullscreen mode
  • level 1
    • level 2
      • level 3

Not sure why a 4 space indent doesn't work, possibly because it's interpreted as code.

derlin profile image
Lucy Linder

Most solutions I found on are so tedious, I created a tool to do it for you: (choose the preset ;))

To know more, see my article: