Convertidores

API interna — Las clases en esta página se utilizan internamente por la canalización de exportación. La mayoría de los desarrolladores interactúan con Document.save() en su lugar. Consulte Core Management para la API pública.

Aspose.Words FOSS for Python utiliza clases convertidoras especializadas para transformar el modelo interno del documento en formatos de salida. ParagraphConverter maneja el texto y el formato, TableConverter maneja las estructuras de tabla y ListHandler gestiona el formato de listas.

Convertidor de párrafos

ParagraphConverter transforma los párrafos del documento al formato de salida objetivo. Inspecciona el formato de los párrafos, el estilo a nivel de ejecución y el contenido en línea.

Método	Descripción
`ParagraphConverter.get_paragraph_info()`	Extraer información de formato de un párrafo
`ParagraphConverter.get_run_formatting()`	Obtener detalles de formato para una ejecución de texto
`ParagraphConverter.format_text()`	Aplicar formato al contenido de texto

Convertidor de tablas

TableConverter convierte las tablas del documento al formato de destino (como tablas Markdown).

Método	Descripción
`TableConverter.convert()`	Convertir un elemento de tabla al formato de salida

Manejador de Lista

ListHandler gestiona el estado de la lista durante la conversión de documentos, rastreando la anidación de listas, los marcadores y el formato.

Método	Descripción
`ListHandler.set_reader()`	Establecer el lector de documentos para el contexto de lista
`ListHandler.reset()`	Restablecer el estado de seguimiento de la lista
`ListHandler.get_list_info()`	Obtener los detalles del elemento de lista para un párrafo
`ListHandler.format_list_item()`	Formatear un elemento de lista con marcador e indentación
`ListHandler.break_list()`	Señalar el final de una secuencia de lista

Consejos y Mejores Prácticas

Los convertidores se utilizan internamente en la canalización de exportación — la mayoría de los desarrolladores interactúan con Document.save() en su lugar
ParagraphConverter.format_text() respeta el contexto de bloques de código para evitar aplicar formato en línea dentro de fragmentos de código
ListHandler mantiene el estado a través de párrafos de lista consecutivos — llame a reset() al iniciar una nueva sección del documento

Problemas comunes

Problema	Causa	Solución
Columnas de tabla desalineadas	La tabla de entrada tiene celdas combinadas	`TableConverter` maneja tablas simples; las celdas combinadas pueden producir una salida inesperada
Numeración de lista rota	El estado de la lista no se restablece entre secciones	Llame a `ListHandler.reset()` en los límites de sección

Resumen de la referencia de API

Clase / Método	Descripción
`ParagraphConverter.get_paragraph_info()`	Extraer formato de párrafo
`ParagraphConverter.get_run_formatting()`	Obtener formato a nivel de ejecución
`ParagraphConverter.format_text()`	Aplicar formato al texto
`TableConverter.convert()`	Convertir una tabla al formato de salida
`ListHandler.set_reader()`	Establecer el contexto del lector de documentos
`ListHandler.get_list_info()`	Obtener detalles del elemento de lista
`ListHandler.format_list_item()`	Formatear un elemento de lista