In some cases I use chapters headings to redirect elsewhere, to not make the page too long. So it gets like this: ## Exosomes and viruses: two sides of the same coin: [⇐](virus-exosome-en) Here is the part of render-link.html that creates the destination ($destination) part {{- $destination := .…

[image] Customise table of content support This can be done with the .Fragments variable (since 0.111.0). {{ $tocStartLevel := default 2 .Params.toc_start_level }} {{ $tocEndLevel := default 3 .Params.toc_end_level }} {{ $tocOrdered := false }} {{ .Fragments.ToHTML $to…

If I don’t misunderstand, the TOC will extract and make a link to the heading in the {{ .Content }} (H1, H2, H3 … H6) which the lower and upper can be configured by TOC site config.

Yes. as I said it bypasses render-link.html. it creates its own link with whatever it finds within the heading, and that is a faulty behavior. Be it a bug or a faulty design, it’s still bad, whatever’s inside the heading should have it’s markdown processed before going through .TableOfContent

But a link in a table of content should only ever point to a heading on the same page, a fragment identifier on a heading element. If it doesn’t it’s not a table of contents, it’s an index page.

[image] Tom_Durand: Yes. as I said it bypasses render-link.html. it creates its own link with whatever it finds within the heading, and that is a faulty behavior. That it’s faulty behaviour isn’t obvious to me – I have never thought that the ToC links should look/behave like the inline conten…

[image] bep: That said, with the latest Hugo version, there’s a data structure that allows you to build your own table of contents HTML. Which one ?

[image] Page Variables Page-level variables are defined in a content file's front matter, derived from the content's file location, or extracted from the content body itself.

I see… But I don’t get how to use it, there are examples to search into it but not generate stuff from it

@Arif posted a good example. Also, you should follow the link to the Go documentation in Hugo’s. It contains some more details (but is also quite terse).

Links in TOC, .TableOfContent bypasses render-link.html

support

Arif March 16, 2023, 2:05pm 10

Topic		Replies	Views
Problem: TOC and link path support	5	1217	April 2, 2021
Ranging over tables of content on a list page support	2	122	March 9, 2025
Table Of Content HTML partial support	3	846	February 7, 2023
Table of Contents - Render Hook to urlize links support	4	57	February 10, 2026
Navigation links or buttons to jump to each section of markdown page support	3	2405	September 1, 2020

Links in TOC, .TableOfContent bypasses render-link.html

Related topics