URI rewriting Leave feedback
On this page
Use UriExportStrategy with CustomUriExportStrategy and IUriSavingHandler to rewrite resource URIs in the Markdown output. This is useful when images are served from a CDN or a different path than where they’re saved.
NoteURI rewriting works with file-based image strategies (ExportImagesToFileSystemStrategyorCustomImagesStrategy). It has no effect when images are embedded as Base64.
using GroupDocs.Markdown;
public class CdnUriHandler : IUriSavingHandler
{
public void Handle(UriSavingArgs args)
{
args.SetResourceFileUri("https://cdn.example.com/assets/" + args.ResourceFileName);
}
}
var options = new ConvertOptions
{
ImageExportStrategy = new ExportImagesToFileSystemStrategy("output/images")
{
ImagesRelativePath = "images"
},
UriExportStrategy = new CustomUriExportStrategy(new CdnUriHandler())
};
MarkdownConverter.ToFile("business-plan.docx", "output/report.md", options);
// Images saved locally to output/images/
// Markdown references: 
business-plan.docx is a sample file used in this example. Click here to download it.
output/images/img-001.png (4 KB)
output/images/img-002.jpg (41 KB)
output/images/img-003.png (14 KB)
output/report.md (5 KB)
| Property | Description |
|---|---|
ResourceFileName | Default file name generated by the library |
ResourceFileUri | Default URI that would appear in the Markdown |
SetResourceFileUri(string) | Override the URI written to the Markdown output |
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
