Statement
The theme shall rewrite file-relative markdown links targeting .md/.mdx files to their canonical route URLs at build time, so authors can use natural inter-document linking across routed content collections.
Rationale
Astro does not rewrite markdown file-relative links to generated routes. Without build-time rewriting, authors must know the routing scheme and use explicit route paths, which is fragile and unnatural for markdown authoring.
Topics
Owner: content-authoring
Related: theming-reuse
Applies To
- Build & Request Pipeline DOC-00084