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. Pr         


        

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).