# 在 Android 上将 PowerPoint 演示文稿转换为 Markdown

> 使用 Aspose.Slides for Android 通过 Java 将 PowerPoint 幻灯片（PPT、PPTX）转换为干净的 Markdown，自动化文档编写并保持格式。

Source: https://docs.aspose.com/slides/zh/androidjava/convert-powerpoint-to-markdown/
Updated: 2026-01-22


Aspose.Slides 支持将演示文稿转换为 Markdown。

{{% alert color="warning" %}} 
PowerPoint 导出为 markdown 默认 **不包含图像**。如果您想导出包含图像的 PowerPoint 文档，需要设置 `markdownSaveOptions.setExportType(MarkdownExportType.Visual)`，并且还要设置 `BasePath`，以确定 markdown 文档中引用的图像保存位置。
{{% /alert %}} 

## **将 PowerPoint 转换为 Markdown**

1. 创建一个 [Presentation](https://reference.aspose.com/slides/androidjava/com.aspose.slides/presentation/) 类的实例，以表示演示文稿对象。
2. 使用 [Save ](https://reference.aspose.com/slides/androidjava/com.aspose.slides/presentation/#save-com.aspose.slides.IXamlOptions-) 方法将对象保存为 markdown 文件。

以下 Java 代码演示如何将 PowerPoint 转换为 markdown：
```java
Presentation pres = new Presentation("pres.pptx");
try {
    pres.save("pres.md", SaveFormat.Md);
} finally {
    if (pres != null) pres.dispose();
}
```


## **将 PowerPoint 转换为 Markdown 变体**

Aspose.Slides 允许您将 PowerPoint 转换为 markdown（包含基本语法）、CommonMark、GitHub 风格的 markdown、Trello、XWiki、GitLab 以及其他 17 种 markdown 变体。

以下 Java 代码演示如何将 PowerPoint 转换为 CommonMark：
```java
Presentation pres = new Presentation("pres.pptx");
try {
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setFlavor(Flavor.CommonMark);
    pres.save("pres.md", SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}
```


这 23 种受支持的 markdown 变体在 [Flavor 枚举](https://reference.aspose.com/slides/androidjava/com.aspose.slides/flavor/) 中列出，来自 [MarkdownSaveOptions](https://reference.aspose.com/slides/androidjava/com.aspose.slides/markdownsaveoptions/) 类。

## **将包含图像的演示文稿转换为 Markdown**

[MarkdownSaveOptions](https://reference.aspose.com/slides/androidjava/com.aspose.slides/markdownsaveoptions/) 类提供属性和枚举，允许您为生成的 markdown 文件使用特定的选项或设置。例如，[MarkdownExportType](https://reference.aspose.com/slides/androidjava/com.aspose.slides/markdownexporttype/) 枚举可以设置为决定图像渲染或处理方式的值：`Sequential`、`TextOnly`、`Visual`。

### **顺序转换图像**

如果您希望图像在生成的 markdown 中一个接一个单独出现，需要选择 sequential 选项。以下 Java 代码演示如何将包含图像的演示文稿转换为 markdown：
```java
Presentation pres = new Presentation("pres.pptx");
try {
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setShowHiddenSlides(true);
    markdownSaveOptions.setShowSlideNumber(true);
    markdownSaveOptions.setFlavor(Flavor.Github);
    markdownSaveOptions.setExportType(MarkdownExportType.Sequential);
    markdownSaveOptions.setNewLineType(NewLineType.Windows);
    pres.save("doc.md", new int[] { 1, 2, 3, 4, 5, 6, 7, 8, 9 }, SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}
```


### **视觉转换图像**

如果您希望图像在生成的 markdown 中一起出现，需要选择 visual 选项。在这种情况下，图像将保存到应用程序的当前目录（并在 markdown 文档中为其构建相对路径），或者您可以指定首选的路径和文件夹名称。

以下 Java 代码演示此操作：
```java
Presentation pres = new Presentation("pres.pptx");
try {
    final String outPath = "c:/documents";
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setExportType(MarkdownExportType.Visual);
    markdownSaveOptions.setImagesSaveFolderName("md-images");
    markdownSaveOptions.setBasePath(outPath);
    pres.save("pres.md", SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}
```


## **常见问题**

**超链接在导出为 Markdown 时会保留吗？**

是的。文本 [hyperlinks](/slides/zh/androidjava/manage-hyperlinks/) 会保留为标准的 Markdown 链接。幻灯片 [transitions](/slides/zh/androidjava/slide-transition/) 和 [animations](/slides/zh/androidjava/powerpoint-animation/) 不会被转换。

**我可以通过多线程运行来加快转换速度吗？**

可以在文件之间并行处理，但不要在多个线程之间共享同一个 [Presentation](https://reference.aspose.com/slides/androidjava/com.aspose.slides/presentation/) 实例。[don’t share](/slides/zh/androidjava/multithreading/) 请使用每个文件的独立实例/进程，以避免竞争。

**图像会怎样处理——它们保存在哪里，路径是否为相对路径？**

[Images](/slides/zh/androidjava/image/) 会导出到专用文件夹，Markdown 文件默认使用相对路径引用它们。您可以配置基础输出路径和资产文件夹名称，以保持可预测的仓库结构。