Old URL map

Reading time 3 min

This showcase retains explicit legacy-address rules in static/_redirects, copied to the build output root. They are showcase host configuration, not a built-in MarkStack redirect engine. The table below represents all 56 declarations in the retained file. Root / stays the homepage; it has no self-redirect declaration.

Explicit redirect declarations

All destination links point to root-relative V2 handbook routes; use the link target for the exact destination path. Each rule uses 301. Slash and non-slash variants are explicit declarations, not evidence that every possible legacy spelling is known.

Source paths below are split by base to fit phones. Join the named base and suffix exactly. “(base without slash)” means the base itself; / means its slash form. No spaces are part of a source path.

Base /architecture

Suffix Destination
/ Architecture and contributing
(base without slash) Architecture and contributing
/build-pipeline Build internals
/build-pipeline/ Build internals
/navigation-and-routing Content structure
/navigation-and-routing/ Content structure
/search-indexing Build internals
/search-indexing/ Build internals

Base /authoring-content

Suffix Destination
/ Write documentation
(base without slash) Write documentation
/content-model Content structure
/content-model/ Content structure
/examples Markdown lab
/examples/ Markdown lab
/frontmatter Frontmatter
/frontmatter/ Frontmatter
/markdown-features Markdown syntax
/markdown-features/ Markdown syntax
/media-and-links Links and media
/media-and-links/ Links and media
/visual-editor Editor handbook
/visual-editor/ Editor handbook

Base /build-and-deploy

Suffix Destination
/ Build and publish
(base without slash) Build and publish
/cicd-integration Review and release
/cicd-integration/ Review and release
/commands-reference Commands
/commands-reference/ Commands
/deployment-guide Static deployment
/deployment-guide/ Static deployment

Base /configuration

Suffix Destination
/ Configuration
(base without slash) Configuration
/homepage-content Site settings
/homepage-content/ Site settings
/site-config Site settings
/site-config/ Site settings

Base /customization

Suffix Destination
/ Templates and styling
(base without slash) Templates and styling
/templates Templates and styling
/templates/ Templates and styling
/themes-and-styling Templates and styling
/themes-and-styling/ Templates and styling

Base /getting-started

Suffix Destination
/ Start
(base without slash) Start
/installation Fresh install script
/installation/ Fresh install script
/project-structure Project map
/project-structure/ Project map
/quickstart First site
/quickstart/ First site

Base /troubleshooting

Suffix Destination
/ Troubleshooting and support
(base without slash) Troubleshooting and support
/common-issues Troubleshooting and support
/common-issues/ Troubleshooting and support
/frequently-asked-questions FAQ and support
/frequently-asked-questions/ FAQ and support

Cloudflare Pages mechanism

The official Pages redirects documentation describes a plain-text _redirects file in the deployable static output. Each line is source destination code; comment lines start with #. Pages parses the file rather than serving it as a static asset. The provider default is 302 when no code is supplied; these declarations explicitly select 301.

Rules apply to static asset responses, not requests handled by Pages Functions. For a Function-owned route, implement the required behavior in the Function or exclude it from Functions. MarkStack’s disposable preview server does not execute these redirect rules, and other hosting products need their own configuration.

Provider limits and ordering

Rule Current Pages documentation
Static redirects Up to 2,000
Dynamic redirects Up to 100
Combined total Up to 2,100
Declaration length Up to 1,000 characters
Duplicate source First matching rule wins
Source fragments Not evaluated by network

Place static rules before dynamic rules. A destination can include a fragment, but a source fragment is browser-side and not matched by the network. Do not replace this explicit map with a broad homepage fallback: unknown addresses should return a real 404, not silently become home. Permanent redirects can be cached, so inspect a proposed mapping before release.

Acceptance checks

Check Expected evidence
Output file Intended declarations present
Local destination Real generated page/fragment
Hosted source Intended status and Location
Final destination Correct content, no loop
Unknown route HTTP404, not homepage200
Slash variants Both intended declarations tested

Local build-target validation can verify destinations, but not provider rule application. Recheck every declaration on the deployed host after release, including final content and redirect chains. A prior host result is not proof a later deployment kept the file, static routing or correct destinations. When an old live address is discovered outside this file, verify its intended replacement before adding a rule.

The provider mechanics above were checked against its official page on 12 October 2026. There is no new live redirect certification attached to this unpublished draft.