[Help] How to insert permalinks to headings?

[enricogandini]

I am new to Pelican (and to web development). I would like to create a simple blog using Pelican, and I have chosen the awesome Elegant theme.

By browsing websites built with the Elegant theme (and the official Elegant theme website itself), I found out that the headings in the articles have permalinks: by hovering the mouse on the heading, the "chain" icon appears, with a link to the webpage itself, ending with a # symbol followed by the slugified heading. I think that the feature is very useful, since it allows sharing a link to a specific part of an article.

How can I do that in my website? I was not able to find a clear answer. I am using reStructuredText, not Markdown.
I found this article on the official website, but it is Markdown-specific: is it the only way to get permalinks to headings? Should I use Markdown instead of reStructuredText?

I also tried the permalink plugin, but I was not able to make it work: it is not well-documented, and probably it is no longer supported.

The only way I found to get a similar (but not identical) result is through the reStructuredText contents directive. But I would prefer the permalinks that I found in the Elegant websites I have browsed.

I thank you in advance for any suggestions, and I apologize if this is not the right place to ask this question. Maybe I should have tried the Pelican GitHub page, but I thought that there may be an Elegant-specific solution to the problem (even though the problem occurs with all the themes I have tried).

I am using the latest production release of Elegant, with Pelican 4.7.1, and Python 3.10.1.