Skip to content

fix: always use .md extension in links for Docusaurus compatibility - #22

Open
philpax wants to merge 1 commit into
Jan0660:mainfrom
goatcorp:fix/md-extension-links
Open

philpax wants to merge 1 commit into
Jan0660:mainfrom
goatcorp:fix/md-extension-links

Conversation

@philpax

@philpax philpax commented Mar 27, 2026

Copy link
Copy Markdown
Contributor

Without .md extensions, Docusaurus passes links through as raw URL paths. When browsers resolve these relative URLs against pages served with trailing slashes, the relative path goes one level too few, producing duplicated namespace segments in the resolved URL.

Always using .md extensions tells Docusaurus to resolve links as file references at build time, which is immune to trailing slash behavior.

This fix was made to address goatcorp/dalamud-docs#51.

Without .md extensions, Docusaurus passes links through as raw URL
paths. When browsers resolve these relative URLs against pages served
with trailing slashes, the relative path goes one level too few,
producing duplicated namespace segments in the resolved URL.

Always using .md extensions tells Docusaurus to resolve links as file
references at build time, which is immune to trailing slash behavior.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant