Indispensable plumbing for any hosted documentation setup. Rewrites link and image URLs after parsing so your markdown stays decoupled from your deployment URL. Rules are composable and applied in sequence: prepend a base URI, swap URLs by exact match, replace with a regex pattern, or run a custom callback. Chain as many as you need.
composer require alto/commonmarkuse Alto\CommonMark\Extension\LinkRewriter\LinkRewriterExtension;
use League\CommonMark\Environment\Environment;
$environment = new Environment();
$environment->addExtension(new LinkRewriterExtension([
'base_uri' => 'https://docs.example.com',
]));No custom markdown directive is required; standard links/images are rewritten during document processing.
base_uri: prepends a base URL to relative links.map: exact URL mapping array.pattern: regex replacement pair (pattern+replacement).callback: custom callable for advanced rewriting.
[Guide](/getting-started)
This extension is actively developed in the alto/commonmark monorepo.
MIT License -- Simon André & Alto