Docusaurus v3 markdown links don't resolve correctly from index pages during build step when trailingSlash is set to false

[maxweisel]

Docusaurus v3 markdown links don't resolve correctly from index pages during build step when trailingSlash is set to false

[maxweisel]

Just saw the note about adding .md extensions. I'll use that. Thank you

[slorber]

Despite the error saying it was resolved as /cool-page it is in fact not.

There is nothing at /cool-page. For your link to work, it must be resolved as /docs/cool-page.

And trailingSlash has an impact on relative link resolution.

---

I'm sorry but your sandbox does not match your text description, which makes things confusing. Please try again by having the text and the sandbox being in sync.

For example your sandbox is using a relative path link (which we don't recommend because it's sensitive to trailingSlash setting changes)

[Cool page](../test2/cool-page)

While your text is using a relative reference to a markdown file

[Cool page](../cool-page.md) 

Those 2 are not the same at all, and will not resolve the same.

---

Most likely it's a mistake on your side, so I'm closing as can't repro. The behavior you see in your sandbox is the expected behavior.

[maxweisel]

The bug works the same regardless of the location of the page being linked. However, I've updated my repro to match the bug /exactly/.

[slorber]

I'm not sure if you expect me to do something, your sandbox now includes many other broken links due to removing other md files.

[Cool page](../cool-page)

[Cool page](../cool-page.md)

The 1st doesn't work, and it's expected because ../cool-page resolved from /docs/test resolves as /cool-page, a path that does not exist

The 2nd work because it's resolved as /test/cool-page, that exists.

I maintain that all this works as intended. If you still believe otherwise please create a minimal repro showing a single broken link being reported and explain why you think the error is a false positive.

Also make sure to properly understand how relative links work on the web (this is not a Docusaurus feature, it is how regular html pages and browsers work, we use the same resolution algo).

Also make sure to read that doc:

[maxweisel]

I'm still seeing this bug if an image links to a markdown file. This fails claiming the link is broken: [![Cool Page](https://docusaurus.io/img/docusaurus.svg)](../cool-page.md):

  Exhaustive list of all broken links found:
  - Broken link on source page path = /docs/test:
     -> linking to ../cool-page.md (resolved as: /cool-page.md)

As soon as I switch it to a text link, it works despite having the same link path.

I've updated the repro project here: https://codesandbox.io/p/devbox/runtime-pine-84xm8d

[slorber]

Can confirm the bug, related to resolving relative file paths when using an image.

Can reproduce this on our own website:

[text](./installation.mdx)

[![alt](/img/slash-introducing.svg)](./installation.mdx)

Only the first link resolves.

Definitively a bug. Track #9048 for the root cause and the solution. We can keep this issue closed.