Skip to content

Raw on-domain .md uses source-relative links that 404 when fetched #177

Description

@armcconnell

The per-page Markdown emitted by hooks/emit_markdown.py (e.g. /setup/index.md) keeps MkDocs source-relative links like [Glossary](glossary.md). Fetched at /setup/index.md, that resolves to /setup/glossary.md (404) instead of /glossary/.

MkDocs rewrites these at build time for HTML but not for the raw source we now serve, so agents following links in the .md will miss.

Fix: rewrite intra-doc links to absolute site URLs (or to the sibling index.md) when emitting the Markdown. Follow-up to #176.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions