Skip to content

SLIDESDOC-627 Update article text to improve time to read #786

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Aug 20, 2025
Merged

SLIDESDOC-627 Update article text to improve time to read #786

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
65684d8
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 11, 2025
972c57e
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 12, 2025
8110dfd
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 13, 2025
497a872
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 13, 2025
710a69c
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 13, 2025
2e4bef0
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 14, 2025
35db95e
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 15, 2025
c683582
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 15, 2025
0993fdc
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 15, 2025
8b6aae6
SLIDESDOC-627 Update article text to improve time to read
andreypotapovaspose Aug 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 41 additions & 53 deletions ...onvert-presentation/convert-powerpoint/convert-powerpoint-to-markdown/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,92 +28,80 @@ keywords:
description: "Convert PowerPoint and OpenDocument slides—PPT, PPTX, ODP—to clean Markdown with Aspose.Slides for Python via .NET, automate documentation and keep formatting."
---

{{% alert color="info" %}}
## **Convert Presentations to Markdown**

Support for PowerPoint to markdown conversion was implemented in [Aspose.Slides 23.7](https://docs.aspose.com/slides/python-net/aspose-slides-for-python-net-23-7-release-notes/).
The example below shows the simplest way to convert a PowerPoint presentation to Markdown using Aspose.Slides for Python via .NET with default settings.

{{% /alert %}}
1. Instantiate a [Presentation](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) to load the presentation.
1. Call `save` to export it as a Markdown file.

{{% alert color="warning" %}}

PowerPoint to markdown export is **without images** by default. If you want to export a PowerPoint document containing images, you need to set `saveOptions.export_type = MarkdownExportType.VISUAL` also set the `base_path` where the images referenced in the markdown document will be saved.

{{% /alert %}}

## **Convert PowerPoint to Markdown**

1. Create an instance of the [Presentation](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) class to represent a presentation object.
2. Use the [Save](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/#methods) method to save the object as a markdown file.

This Python code shows you how to convert PowerPoint to markdown:
Use the Python snippet below to perform the conversion:

```python
import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
pres.save("pres.md", slides.export.SaveFormat.MD)
with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slides.export.SaveFormat.MD)
```

## Convert PowerPoint to Markdown Flavor
## **Convert Presentations to Markdown Flavor**

Aspose.Slides allows you to convert PowerPoint to markdown (containing basic syntax), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab, and 17 other markdown flavors.
Aspose.Slides allows you to convert presentations to Markdown formats, including basic Markdown, CommonMark, GitHub-flavored Markdown, Trello, XWiki, GitLab, and 17 other Markdown flavors.

This Python code shows you how to convert PowerPoint to CommonMark:
The following Python example shows how to convert a PowerPoint presentation to CommonMark:

```python
from aspose.slides import Presentation
from aspose.slides.dom.export.markdown.saveoptions import MarkdownSaveOptions, Flavor
from aspose.slides.export import SaveFormat
import aspose.slides as slides

with Presentation("pres.pptx") as pres:
saveOptions = MarkdownSaveOptions()
saveOptions.flavor = Flavor.COMMONMARK
save_options = slides.export.MarkdownSaveOptions()
save_options.flavor = slides.export.Flavor.COMMON_MARK

pres.save("pres.md", SaveFormat.MD, saveOptions)
with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slides.export.SaveFormat.MD, save_options)
```

The 23 supported markdown flavors are [listed under the Flavor enumeration](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/flavor/) from the [MarkdownSaveOptions](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownsaveoptions/) class.
The 23 supported Markdown flavors are listed in the [Flavor](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/flavor/) enumeration of the [MarkdownSaveOptions](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownsaveoptions/) class.

## **Convert Presentation Containing Images to Markdown**
## **Convert Presentations Containing Images to Markdown**

The [MarkdownSaveOptions](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownsaveoptions/) class provides properties and enumerations that allow you to use certain options or settings for the resulting markdown file. The [MarkdownExportType](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownexporttype/) enum, for example, can be set to values that determine how images are rendered or handled: `Sequential`, `TextOnly`, `Visual`.
The [MarkdownSaveOptions](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownsaveoptions/) class provides properties and enumerations that let you configure the resulting Markdown file. For example, the [MarkdownExportType](https://reference.aspose.com/slides/python-net/aspose.slides.dom.export.markdown.saveoptions/markdownexporttype/) enum controls how images are handled: `SEQUENTIAL`, `TEXT_ONLY`, or `VISUAL`.

### **Convert Images Sequentially**

If you want the images to appear individually one after the other in the resulting markdown, you have to choose the sequential option. This Python code shows you how to convert a presentation containing images to markdown:
If you want images to appear individually—one after another—in the generated Markdown, choose the `SEQUENTIAL` option. The Python example below shows how to convert a presentation with images to Markdown.

```python
import aspose.slides as slides

with slides.Presentation("pres.pptx") as pres:
markdownSaveOptions = slides.export.MarkdownSaveOptions()
markdownSaveOptions.show_hidden_slides = True
markdownSaveOptions.show_slide_number = True
markdownSaveOptions.flavor = slides.export.Flavor.GITHUB
markdownSaveOptions.export_type = slides.export.MarkdownExportType.SEQUENTIAL
markdownSaveOptions.new_line_type = slides.export.NewLineType.WINDOWS

pres.save("doc.md", [ 1, 2, 3, 4, 5, 6, 7, 8, 9 ], slides.export.SaveFormat.MD, markdownSaveOptions)
save_options = slides.export.MarkdownSaveOptions()
save_options.show_hidden_slides = True
save_options.show_slide_number = True
save_options.flavor = slides.export.Flavor.GITHUB
save_options.export_type = slides.export.MarkdownExportType.SEQUENTIAL
save_options.new_line_type = slides.export.NewLineType.WINDOWS

slide_indices = [1, 3, 5]

with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slide_indices, slides.export.SaveFormat.MD, save_options)
```

### **Convert Images Visually**

If you want the images to appear together in the resulting markdown, you have to choose the visual option. In this case, images will be saved to the current directory of the application (and a relative path will be built for them in the markdown document), or you can specify your preferred path and folder name.
If you want the images to appear together in the resulting Markdown, choose the `VISUAL` option. In this mode, images are saved to the application’s current directory (and the Markdown document uses relative paths), or you can specify a custom output path and folder name.

This Python code demonstrates the operation:
The Python example below demonstrates this operation:

```python
from aspose.slides import Presentation
from aspose.slides.dom.export.markdown.saveoptions import MarkdownSaveOptions, MarkdownExportType
from aspose.slides.export import SaveFormat

with Presentation("pres.pptx") as pres:
outPath = "c:\\documents"
import os
import aspose.slides as slides

saveOptions = MarkdownSaveOptions()
saveOptions.export_type = MarkdownExportType.VISUAL
saveOptions.images_save_folder_name = "md-images"
saveOptions.base_path = outPath
save_options = slides.export.MarkdownSaveOptions()
save_options.export_type = slides.export.MarkdownExportType.VISUAL
save_options.images_save_folder_name = "md-images"
save_options.base_path = "c:\\documents"

pres.save(outPath + "\\pres.md", SaveFormat.MD, saveOptions)
with slides.Presentation("presentation.pptx") as presentation:
file_path = os.path.join(save_options.base_path, "presentation.md")
presentation.save(file_path, slides.export.SaveFormat.MD, save_options)
```
68 changes: 32 additions & 36 deletions ...ion/convert-presentation/convert-powerpoint/convert-powerpoint-to-png/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,72 +22,68 @@ keywords:
description: "Convert PowerPoint and OpenDocument presentations to high-quality PNG images quickly with Aspose.Slides for Python via .NET, ensuring precise, automated results."
---

## **About PowerPoint to PNG Conversion**
## **Overview**

The PNG (Portable Network Graphics) format is not as popular as JPEG (Joint Photographic Experts Group), but it still very popular.
Aspose.Slides for Python via .NET makes it straightforward to convert PowerPoint presentations to PNG. You load a presentation, iterate through its slides, render each one to a raster image, and save the result as PNG files. This is ideal for generating slide previews, embedding slides in web pages, or producing static assets for downstream processing.

**Use case:** When you have a complex image and size is not an issue, PNG is a better image format than JPEG.
## **Convert Slides to PNG**

{{% alert title="Tip" color="primary" %}} You may want to check out Aspose free **PowerPoint to PNG Converters**: [PPTX to PNG](https://products.aspose.app/slides/conversion/pptx-to-png) and [PPT to PNG](https://products.aspose.app/slides/conversion/ppt-to-png). They are a live implementation of the process described on this page. {{% /alert %}}

## **Convert PowerPoint to PNG**
This section shows the simplest possible example of converting a PowerPoint presentation to PNG images using Aspose.Slides for Python via .NET.

Go through these steps:

1. Instantiate the [Presentation](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) class.
2. Get the slide object from the [Presentation.Slides](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) collection under the [ISlide](https://reference.aspose.com/slides/python-net/aspose.slides/islide/) interface.
3. Use a [ISlide.GetImage](https://reference.aspose.com/slides/python-net/aspose.slides/islide/) method to get the thumbnail for each slide.
4. Use the [IPresentation.SaveMethod(String, SaveFormat, ISaveOptions](https://reference.aspose.com/slides/python-net/aspose.slides/ipresentation/) method to save the slide thumbnail to the PNG format.
1. Get a slide from the `Presentation.slides` collection (see the [Slide](https://reference.aspose.com/slides/python-net/aspose.slides/slide/) class).
1. Use the `Slide.get_image` method to generate a thumbnail of the slide.
1. Use the `Presentation.save` method to save the slide thumbnail in PNG format.

This Python code shows you how to convert a PowerPoint presentation to PNG:
This Python code shows how to convert a PowerPoint presentation to PNG:

```py
import aspose.slides as slides

pres = slides.Presentation("pres.pptx")

for index in range(pres.slides.length):
slide = pres.slides[index]
with slide.get_image() as image:
image.save("slide_{i}.png".format(i = index), slides.ImageFormat.PNG)
with slides.Presentation("presentation.pptx") as presentation:
for index, slide in enumerate(presentation.slides):
with slide.get_image() as image:
image.save(f"slide_{index}.png", slides.ImageFormat.PNG)
```

## **Convert PowerPoint to PNG With Custom Dimensions**
## **Convert Slides to PNG with Custom Dimensions**

If you want to obtain PNG files around a certain scale, you can set the values for `desiredX` and `desiredY`, which determine the dimensions of the resulting thumbnail.
To export slides to PNG at a custom scale, call `Slide.get_image` with horizontal and vertical scale factors. These multipliers resize the output relative to the slide’s original dimensions—for example, `2.0` doubles both width and height. Use equal values for `scale_x` and `scale_y` to preserve the aspect ratio.

This code in Python demonstrates the described operation:
This Python code demonstrates the described operation:

```py
import aspose.slides as slides

pres = slides.Presentation("pres.pptx")
scale_x = 2
scale_y = scale_x

scaleX = 2
scaleY = 2
for index in range(pres.slides.length):
slide = pres.slides[index]
with slide.get_image(scaleX, scaleY) as image:
image.save("slide_{index}.png".format(index=index), slides.ImageFormat.PNG)
with slides.Presentation("presentation.pptx") as presentation:
for index, slide in enumerate(presentation.slides):
with slide.get_image(scale_x, scale_y) as image:
image.save(f"slide_{index}.png", slides.ImageFormat.PNG)
```

## **Convert PowerPoint to PNG With Custom Size**

If you want to obtain PNG files around a certain size, you can pass your preferred `width` and `height` arguments for `ImageSize`.
## **Convert Slides to PNG with Custom Size**

This code shows you how to convert a PowerPoint to PNG while specifying the size for the images:
If you want to generate PNG files at a specific size, pass your desired `width` and `height` values. The code below shows how to convert a PowerPoint to PNG while specifying the image size:

```py
import aspose.slides as slides
import aspose.pydrawing as drawing

pres = slides.Presentation(path + "pres.pptx")

size = drawing.Size(960, 720)

for index in range(pres.slides.length):
slide = pres.slides[index]
with slide.get_image(size) as image:
image.save("slide_{index}.png".format(index=index), slides.ImageFormat.PNG)
with slides.Presentation("presentation.pptx") as presentation:
for index, slide in enumerate(presentation.slides):
with slide.get_image(size) as image:
image.save(f"slide_{index}.png", slides.ImageFormat.PNG)
```

{{% alert title="Tip" color="primary" %}}

You may want to try Aspose’s free **PowerPoint-to-PNG converters**—[PPTX to PNG](https://products.aspose.app/slides/conversion/pptx-to-png) and [PPT to PNG](https://products.aspose.app/slides/conversion/ppt-to-png). They provide a live implementation of the process described on this page.

{{% /alert %}}
Loading