Getting 404 On All Links (Static Site Built with .md, .scss, .html)

[jrwesa]

What Am I Doing Wrong?

Problem: All of my links are broken. Whether I am linking to another page (.md file) or linking to another header (#, ##, etc.), I get a 404 message that reads:

See Links for Broken Links: https://jrwesa.github.io/docs/layout/subcategory/child-1/

Site: Built with the just-the-docs theme and .md, .scss files.

• Repo: https://github.com/jrwesa/jrwesa.github.io/tree/main
• Site URL: https://jrwesa.github.io/

NOTE: Currently, my GitHub Pages site deploys. The navigation seen on the left side of the site reflects my markdown pages.

I had read other threads, but many people are dealing with their site not deploying at all. (Seemingly a problem with their index file, but I'm not sure that is my problem)

[pdmosses]

@jrwesa in your repo you have (e.g.):

A link to the [same level](child-2.md)

The target of a link definition in Markdown needs to be a URL, rather than a path to a file. Depending on your permalink setting, try replacing the above by:

A link to the [same level](child-2)

or by

A link to the [same level](child-2.html)

You can alternatively wrap your file paths in Jekyll's link tag. That has the benefit of checking that the file exists.

[jrwesa]

Thank you for the reply.

Linking seems to work if I used the file path and remove the .md from the markdown file. The following links work:

---

Linking to a .md file/page:

A link to a .md [file/page](/index) with no .md

Linking to .md file/page with an extended file page

A link to a .md [file/page](/docs/layout/subcategory/child-2)

Linking to a header withing a .md file/page

A link to a .md file [header](/index#header-1) with `/index#header-1`

---

I think we're all good now. Thank you for those recommendations. Looks like I needed to remove the .md extension from the markdown files for them to link correctly.

Thank you,
W