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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions