Convertir presentaciones de PowerPoint a Markdown en Android

Convertir PowerPoint a Markdown

  1. Crea una instancia de la clase Presentation para representar un objeto de presentación.
  2. Utiliza el método Save para guardar el objeto como un archivo markdown.

Este código Java muestra cómo convertir PowerPoint a markdown:

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

Convertir PowerPoint a un Sabor de Markdown

Aspose.Slides permite convertir PowerPoint a markdown (con sintaxis básica), CommonMark, markdown con formato GitHub, Trello, XWiki, GitLab y 17 sabores de markdown adicionales.

Este código Java muestra cómo convertir PowerPoint a 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();
}

Los 23 sabores de markdown compatibles están listados bajo la enumeración Flavor de la clase MarkdownSaveOptions.

Convertir una Presentación que Contiene Imágenes a Markdown

La clase MarkdownSaveOptions proporciona propiedades y enumeraciones que permiten aplicar ciertas opciones o configuraciones al archivo markdown resultante. El enum MarkdownExportType, por ejemplo, puede establecerse en valores que determinan cómo se procesan o renderizan las imágenes: Sequential, TextOnly, Visual.

Convertir Imágenes Secuencialmente

Si deseas que las imágenes aparezcan individualmente una tras otra en el markdown resultante, debes elegir la opción secuencial. Este código Java muestra cómo convertir una presentación que contiene imágenes a 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();
}

Convertir Imágenes Visualmente

Si deseas que las imágenes aparezcan juntas en el markdown resultante, debes elegir la opción visual. En este caso, las imágenes se guardarán en el directorio actual de la aplicación (y se generará una ruta relativa para ellas en el documento markdown), o puedes especificar la ruta y el nombre de carpeta que prefieras.

Este código Java demuestra la operación:

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

¿Se conservan los hipervínculos al exportar a Markdown?

Sí. Los hipervínculos de texto se conservan como enlaces Markdown estándar. Las transiciones de diapositivas y las animaciones no se convierten.

¿Puedo acelerar la conversión ejecutándola en varios hilos?

Puedes paralelizar por archivos, pero no compartas la misma instancia de Presentation entre hilos. Utiliza instancias o procesos separados por archivo para evitar contenciones.

¿Qué ocurre con las imágenes, dónde se guardan y son rutas relativas?

Images se exportan a una carpeta dedicada, y el archivo Markdown las referencia con rutas relativas por defecto. Puedes configurar la ruta de salida base y el nombre de la carpeta de recursos para mantener una estructura de repositorio predecible.