Converter apresentações PowerPoint para Markdown no Android

Introdução

Aspose.Slides permite converter apresentações PowerPoint para Markdown, o que pode ser útil em fluxos de trabalho de documentação, geração de sites estáticos, migração de conteúdo e publicação de texto versionada. A API oferece exportação direta de apresentações PPT e PPTX para arquivos MD e fornece opções adicionais para controlar como o conteúdo dos slides é representado no documento Markdown resultante.

Você pode exportar apresentações como Markdown puro, escolher entre vários sabores de Markdown como CommonMark e GitHub Flavored Markdown, e configurar como as imagens são tratadas durante a exportação. Para apresentações que contêm conteúdo visual, Aspose.Slides também permite salvar as imagens em uma pasta separada e referenciá‑las a partir do arquivo Markdown gerado.

Aspose.Slides oferece suporte à conversão de apresentações para Markdown.

A exportação de PowerPoint para markdown é sem imagens por padrão. Se desejar exportar um documento PowerPoint contendo imagens, é necessário definir markdownSaveOptions.setExportType(MarkdownExportType.Visual) e também definir o BasePath onde as imagens referenciadas no documento markdown serão salvas.

Converter PowerPoint para Markdown

1. Crie uma instância da classe Presentation para representar um objeto de apresentação.
2. Use o método Save para salvar o objeto como um arquivo markdown.

Este código Java mostra como converter PowerPoint para markdown:

Presentation pres = new Presentation("pres.pptx");
try {
    pres.save("pres.md", SaveFormat.Md);
} finally {
    if (pres != null) pres.dispose();
}

Converter PowerPoint para Variação de Markdown

Aspose.Slides permite converter PowerPoint para markdown (contendo sintaxe básica), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab e mais 17 variações de markdown.

Este código Java mostra como converter PowerPoint para CommonMark:

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();
}

Os 23 sabores de markdown suportados estão listados na enumeração Flavor da classe MarkdownSaveOptions.

Converter uma Apresentação contendo Imagens para Markdown

A classe MarkdownSaveOptions fornece propriedades e enumerações que permitem usar determinadas opções ou configurações para o arquivo markdown resultante. O enum MarkdownExportType pode ser definido com valores que determinam como as imagens são renderizadas ou tratadas: Sequential, TextOnly, Visual.

Converter Imagens Sequencialmente

Se desejar que as imagens apareçam individualmente, uma após a outra, no markdown resultante, escolha a opção sequencial. Este código Java mostra como converter uma apresentação contendo imagens para markdown:

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();
}

Converter Imagens Visualmente

Se desejar que as imagens apareçam juntas no markdown resultante, escolha a opção visual. Nesse caso, as imagens serão salvas no diretório atual da aplicação (e um caminho relativo será criado para elas no documento markdown), ou você pode especificar o caminho e o nome da pasta desejados.

Este código Java demonstra a operação:

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();
}

FAQ

Os hiperlinks sobrevivem à exportação para Markdown?

Sim. Texto hyperlinks são preservados como links Markdown padrão. transitions e animations de slides não são convertidos.

Posso acelerar a conversão executando‑a em múltiplas threads?

É possível paralelizar entre arquivos, mas não compartilhe a mesma instância de Presentation entre threads. Use instâncias ou processos separados por arquivo para evitar contenção.

O que acontece com as imagens — onde são salvas e os caminhos são relativos?

Images são exportadas para uma pasta dedicada, e o arquivo Markdown as referencia com caminhos relativos por padrão. Você pode configurar o caminho base de saída e o nome da pasta de ativos para manter uma estrutura de repositório previsível.