Save image by custom strategy Leave feedback
Use CustomImagesStrategy with the IImageSavingHandler interface for full control over how each image is saved during conversion. You can rename files, redirect output to a custom stream, or replace image content entirely.
Implement IImageSavingHandler to customize saving logic for each image:
using GroupDocs.Markdown;
// Implement the IImageSavingHandler interface
public class RenameHandler : IImageSavingHandler
{
private int _index;
public void Handle(CustomImageSavingArgs args)
{
args.SetOutputImageFileName($"img_{_index}_{args.ImageFileName}");
_index++;
}
}
// Use the handler with CustomImagesStrategy
var handler = new RenameHandler();
var options = new ConvertOptions
{
ImageExportStrategy = new CustomImagesStrategy("output/images", handler)
};
MarkdownConverter.ToFile("business-plan.docx", "output/document.md", options);
business-plan.docx is a sample file used in this example. Click here to download it.
output/document.md (5 KB)
output/images/img_0_img-001.png (4 KB)
output/images/img_1_img-002.jpg (41 KB)
output/images/img_2_img-003.png (14 KB)
Use SetReplacementImage to substitute the original image with different content (e.g., a watermarked version or a placeholder):
using System.IO;
using GroupDocs.Markdown;
public class WatermarkHandler : IImageSavingHandler
{
public void Handle(CustomImageSavingArgs args)
{
// Replace the original image with a custom placeholder
Stream placeholder = File.OpenRead("placeholder.png");
args.SetReplacementImage(placeholder);
args.SetOutputImageFileName("placeholder.png");
}
}
var handler = new WatermarkHandler();
var options = new ConvertOptions
{
ImageExportStrategy = new CustomImagesStrategy("output/images", handler)
};
MarkdownConverter.ToFile("business-plan.docx", "output/document.md", options);
business-plan.docx is a sample file used in this example. Click here to download it.
output/document.md (5 KB)
output/images/placeholder.png (14 KB)
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.
