r markdown - Broken bookdown heading link with duplicate names

Question

I am preparing some documentation in bookdown (gitbook) with a heading structure like the following:

1. Subject A
    1.1. Properties
2. Subject B
    2.1. Properties

When I click on the 2.1 link I am directed to section 1.1.

Is it possible to have two headings with the same name and have the links work correctly?

Answer 1

The issue here is that two chapters with the same name are automatically equipped with the same ID. To get different links, you have to assign different IDs to Chapters 1.1. and 2.1 manually by adding {#ID} behind the titles. For example:

# Subject1

text

## Properties {#properties-1}

text

# Subject2

text

## Properties {#properties-2}

text

The ID in {#ID} can then also be used to link to a specific chapter like [this](#ID).