Convertir presentaciones PowerPoint a Markdown en PHP

Visión general

Aspose.Slides for PHP via Java permite la conversión del contenido de presentaciones a Markdown, lo que le permite reutilizar archivos PowerPoint (PPT, PPTX) y OpenDocument (ODP) para wikis, repositorios Git y generadores de sitios estáticos. La API conserva la jerarquía de las diapositivas mientras genera Markdown ligero y legible, de modo que puede automatizar flujos de trabajo de documentación y mantener las presentaciones de origen y los archivos Markdown sincronizados perfectamente.

El soporte para la conversión de PowerPoint a Markdown se implementó en Aspose.Slides 23.7.

Convertir una presentación a Markdown

Esta sección explica cómo Aspose.Slides convierte presentaciones PowerPoint y OpenDocument (PPT, PPTX, ODP) en Markdown limpio, manteniendo la jerarquía original de las diapositivas, el texto y el formato básico intactos para que pueda reutilizar el contenido en documentación o flujos de trabajo con control de versiones sin esfuerzo manual adicional.

1. Cree una instancia de la clase Presentation para representar la presentación.
2. Utilice el método save para exportarla como un archivo Markdown.

Este código PHP muestra cómo convertir una presentación PowerPoint a Markdown:

$presentation = new Presentation("presentation.pptx");
try {
    $presentation->save("presentation.md", SaveFormat::Md);
} finally {
    $presentation->dispose();
}

Convertir una presentación a una variante de Markdown

Aspose.Slides le permite convertir presentaciones PowerPoint a Markdown con sintaxis básica, así como a CommonMark, GitHub‑flavored Markdown, Trello, XWiki, GitLab y diecisiete variantes adicionales de Markdown.

El siguiente código PHP demuestra cómo convertir una presentación PowerPoint a CommonMark:

$presentation = new Presentation("presentation.pptx");
try {
    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setFlavor(Flavor->CommonMark);

    $presentation->save("presentation.md", SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

Las 23 variantes de Markdown compatibles se enumeran en la enumeración Flavor.

Convertir una presentación que contiene imágenes a Markdown

La clase MarkdownSaveOptions expone propiedades y enumeraciones que le permiten configurar el archivo Markdown resultante. Por ejemplo, la enumeración MarkdownExportType especifica cómo se manejan las imágenes: Sequential, TextOnly o Visual.

Por defecto, la exportación de PowerPoint a Markdown no incluye imágenes. Para incrustar imágenes, llame a markdownSaveOptions.setExportType(MarkdownExportType::Visual) y establezca el BasePath que especifica dónde se guardarán las imágenes referenciadas en el archivo Markdown.

Convertir imágenes secuencialmente

Si desea que las imágenes aparezcan individualmente, una tras otra, en el Markdown resultante, debe elegir la opción Sequential. El siguiente código PHP muestra cómo convertir una presentación que contiene imágenes a Markdown:

$presentation = new Presentation("presentation.pptx");
try {
    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setShowHiddenSlides(true);
    $saveOptions->setShowSlideNumber(true);
    $saveOptions->setFlavor(Flavor->Github);
    $saveOptions->setExportType(MarkdownExportType::Sequential);
    $saveOptions->setNewLineType(NewLineType::Windows);

    $slideIndices = array(1, 2, 3, 4);
    $presentation->save("presentation.md", $slideIndices, SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

Convertir imágenes visualmente

Si desea que las imágenes aparezcan juntas en el Markdown resultante, debe elegir la opción Visual. En este caso, las imágenes se guardan en el directorio actual de la aplicación (y se genera una ruta relativa para ellas en el documento Markdown), o puede especificar el directorio y nombre de carpeta que prefiera.

El siguiente código PHP demuestra la operación:

$presentation = new Presentation("presentation.pptx");
try {
    $outPath = "c:/documents";

    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setExportType(MarkdownExportType::Visual);
    $saveOptions->setImagesSaveFolderName("md-images");
    $saveOptions->setBasePath($outPath);

    $presentation->save("presentation.md", SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

Preguntas frecuentes

¿Los hipervínculos sobreviven a la exportación a Markdown?

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

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

Puede paralelizar entre archivos, pero no comparta la misma instancia de Presentation entre hilos. Use instancias/processos separados por archivo para evitar contención.

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

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