Herramienta para la conversión de presentaciones de PowerPoint a formato Markdown.

Instalación Rápida

Para comenzar, clona el repositorio del proyecto e instala las dependencias:

git clone https://gitcode.com/gh_mirrors/pp/pptx2md
cd pptx2md
poetry install
 

Comando Básico de Conversión

La conversión más sencilla requiere especificar el archivo PPT de entrada y la ruta del archivo Markdown de salida:

python -m pptx2md presentation_original.pptx documento_salida.md
 

Este comando transforma todas las diapositivas de presentation_original.pptx a formato Markdown, guardendo el resultado en documento_salida.md. El proceso maneja automáticamente texto, listas, imágenes y tablas, preservando la estructura original.

Funcionalidades Avanzadas

Manejo Personalizado de Imágenes

pptx2md ofrece opciones flexibles para el procesamiento de imágenes. Por defecto, las imágenes se guardan en una carpeta con el mismo nombre que el archivo de salida. Puedes especificar una ruta diferente con el parámetro --image-dir:

python -m pptx2md presentation_original.pptx documento_salida.md --image-dir ./assets_graficos
 

Adicionalmente, ajusta el ancho de las imágenes en Markdown con --image-width:

python -m pptx2md presentation_original.pptx documento_salida.md --image-width 720
 

Soporte para Diseño Multicolumna

Para diapositivas con diseños de múltiples columnas, pptx2md realiza una detección inteligente y las convierte al formato Markdown apropiado, asegurando una representación precisa de diseños complejos.

Niveles de Título Configurables

Utiliza el parámetro --title-file junto con un archivo JSON para definir niveles de título personalizados:

python -m pptx2md presentation_original.pptx documento_salida.md --title-file configuracion_titulos.json
 

Ejemplo de archivo JSON:

{
 "Introducción": 1,
 "Puntos Clave": 2,
 "Conclusiones": 1
}
 

Solución de Problemas Comunes

Conversión de Imágenes

Las imágenes en formato WMF se convierten a PNG. Si la conversión falla, se registrará una advertencia y la imagen se omitirá.

Preservación de Formato de Tablas

Las tablas en las presentaciones se transforman a formato de tabla Markdown, manteniendo la integridad de su estructura y contenido.

Procesamiento de Estilos de Texto

El programa identifica estilos de texto como negrita, cursiva y color, traduciéndolos a la sintaxis Markdown correspondiente.