Save image as file Leave feedback
Use ExportImagesToFileSystemStrategy to save images as separate files during conversion. The Markdown output will contain image references pointing to the exported files.
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy
def image_file_basic():
"""Save images to a folder on disk during PDF to Markdown conversion."""
# Step 1: Configure the file system image export strategy
options = ConvertOptions()
options.image_export_strategy = ExportImagesToFileSystemStrategy("output/images")
# Step 2: Convert and save to file using keyword argument for options
MarkdownConverter.to_file("business-plan.pdf", "output/document.md", convert_options=options)
if __name__ == "__main__":
import os
os.makedirs("output/images", exist_ok=True)
image_file_basic()
business-plan.pdf is sample file used in this example. Click here to download it.
output/document.txt (34 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
... (35 files total)
output/document.txt (33 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
[TRUNCATED] (35 files total)
By default, image references in the Markdown use the full images folder path. Set images_relative_path to produce portable, relative image links:
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy
def image_file_relative():
"""Save images to disk with portable, relative paths in the Markdown output."""
# Step 1: Configure the image export strategy with a relative path
strategy = ExportImagesToFileSystemStrategy("output/images")
strategy.images_relative_path = "images" # produces 
# Step 2: Assign the strategy to conversion options
options = ConvertOptions()
options.image_export_strategy = strategy
# Step 3: Convert and save using keyword argument for options
MarkdownConverter.to_file("business-plan.pdf", "output/document.md", convert_options=options)
# Markdown output contains: 
# Image file saved to: output/images/img-001.png
if __name__ == "__main__":
import os
os.makedirs("output/images", exist_ok=True)
image_file_relative()
business-plan.pdf is sample file used in this example. Click here to download it.
output/document.txt (34 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
... (35 files total)
output/document.txt (33 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
[TRUNCATED] (35 files total)
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.
