Api reference links are broken

[Kostov6]

How to categorize this issue?

/area documentation /kind bug /priority 3

What happened: There are a lot of broken links like MachineSpec

What you expected to happen: It should work like https://github.com/gardener/etcd-druid-api/blob/main/docs/api-reference/druid.md

How to reproduce it (as minimally and precisely as possible):

Anything else we need to know?:

Environment:

• Kubernetes version (use kubectl version):
• Cloud provider or hardware configuration:
• Others: