Converti le presentazioni PowerPoint in Markdown con Java

Introduzione

Aspose.Slides consente di convertire le presentazioni PowerPoint in Markdown, il che può essere utile per flussi di lavoro di documentazione, generazione di siti statici, migrazione di contenuti e pubblicazione di testi sotto controllo di versione. L’API supporta l’esportazione diretta da presentazioni PPT e PPTX in file MD e fornisce opzioni aggiuntive per controllare come il contenuto delle diapositive viene rappresentato nel documento Markdown risultante.

È possibile esportare le presentazioni come Markdown semplice, scegliere tra più varianti di Markdown come CommonMark e GitHub Flavored Markdown, e configurare come le immagini vengono gestite durante l’esportazione. Per le presentazioni che contengono contenuti visivi, Aspose.Slides consente anche di salvare le immagini in una cartella separata e di riferirle dal file Markdown generato.

L’esportazione da PowerPoint a markdown è senza immagini per impostazione predefinita. Se desideri esportare un documento PowerPoint contenente immagini, devi usare markdownSaveOptions.setExportType(MarkdownExportType.Visual) e anche utilizzare setBasePath dove verranno salvate le immagini riferite nel documento markdown.

Converti PowerPoint in Markdown

1. Crea un’istanza della classe Presentation per rappresentare un oggetto presentazione.
2. Usa il metodo Salva per salvare l’oggetto come file markdown.

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

Converti PowerPoint in Variante Markdown

Aspose.Slides consente di convertire PowerPoint in markdown (contenente sintassi di base), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab e altre 17 varianti di markdown.

Questo codice Java mostra come convertire PowerPoint in 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();
}

Le 23 varianti di markdown supportate sono elencate sotto l’enumerazione Flavor nella classe MarkdownSaveOptions.

Converti una Presentazione con Immagini in Markdown

La classe MarkdownSaveOptions fornisce proprietà ed enumerazioni che consentono di utilizzare determinate opzioni o impostazioni per il file markdown risultante. L’enumerazione MarkdownExportType, ad esempio, può essere impostata su valori che determinano come le immagini vengono rese o gestite: Sequential, TextOnly, Visual.

Converti le Immagini Sequenzialmente

Se desideri che le immagini compaiano individualmente una dopo l’altra nel markdown risultante, devi scegliere l’opzione sequenziale. Questo codice Java mostra come convertire una presentazione con immagini in 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();
}

Converti le Immagini Visivamente

Se desideri che le immagini compaiano insieme nel markdown risultante, devi scegliere l’opzione visuale. In questo caso, le immagini verranno salvate nella directory corrente dell’applicazione (e verrà costruito un percorso relativo per esse nel documento markdown), oppure puoi specificare il percorso e il nome della cartella preferiti.

Questo codice Java dimostra l’operazione:

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

I collegamenti ipertestuali sopravvivono all’esportazione in Markdown?

Sì. I collegamenti ipertestuali nel testo vengono conservati come normali link Markdown. Le transizioni e le animazioni delle diapositive non vengono convertite.

Posso velocizzare la conversione eseguendola in più thread?

Puoi parallelizzare tra file, ma non condividere la stessa istanza di Presentation tra thread. Usa istanze/processi separati per file per evitare conflitti.

Cosa succede alle immagini — dove vengono salvate e i percorsi sono relativi?

Le immagini vengono esportate in una cartella dedicata e il file Markdown le riferisce con percorsi relativi per impostazione predefinita. Puoi configurare il percorso di output di base e il nome della cartella degli asset per mantenere una struttura di repository prevedibile.