Hugo Link Pitfalls & Fixes

Symptoms seen

• Menu works, but inline links do nothing (address bar changes, content doesn't).
• Links 404 or resolve to .md instead of pretty URLs.

Root Causes

• PaperMod's instant navigation expects canonical URLs with trailing slashes.
• Mismatch between filename and URL slug.

Fixes

1. Use pretty URLs:

   uglyURLs = false
   [permalinks]
     page = "/page/:slug/"
   

2. Pin slugs in frontmatter:

   ---
   title: "Report a Bug"
   slug: "report-bug"
   ---
   

3. Use trailing slashes in Markdown links: /page/report-bug/.
4. If in doubt, use absolute links: https://endershollow.com/page/report-bug/.