Conversores

Aspose.Words FOSS for Python usa classes conversoras especializadas para transformar o modelo interno de documento em formatos de saída. ParagraphConverter lida com texto e formatação, TableConverter lida com estruturas de tabela, e ListHandler gerencia a formatação de listas.

Conversor de Parágrafos

ParagraphConverter transforma os parágrafos do documento no formato de saída desejado. Ele inspeciona a formatação de parágrafos, o estilo ao nível de execução e o conteúdo embutido.

Método	Descrição
`ParagraphConverter.get_paragraph_info()`	Extrair informações de formatação de um parágrafo
`ParagraphConverter.get_run_formatting()`	Obter detalhes de formatação para uma sequência de texto
`ParagraphConverter.format_text()`	Aplicar formatação ao conteúdo de texto

Conversor de Tabela

TableConverter converte tabelas de documentos para o formato de destino (como tabelas Markdown).

Método	Descrição
`TableConverter.convert()`	Converter um elemento de tabela para o formato de saída

Manipulador de Lista

ListHandler gerencia o estado da lista durante a conversão de documentos, rastreando o aninhamento de listas, marcadores e formatação.

Método	Descrição
`ListHandler.set_reader()`	Definir o leitor de documento para o contexto de lista
`ListHandler.reset()`	Redefinir o estado de rastreamento da lista
`ListHandler.get_list_info()`	Obter detalhes do item de lista para um parágrafo
`ListHandler.format_list_item()`	FormatAR um item de lista com marcador e recuo
`ListHandler.break_list()`	Sinalizar o fim de uma sequência de lista

Dicas e Melhores Práticas

Os conversores são usados internamente pelo pipeline de exportação — a maioria dos desenvolvedores interage com Document.save() em vez disso
ParagraphConverter.format_text() respeita o contexto de blocos de código para evitar a aplicação de formatação inline dentro de trechos de código
ListHandler mantém o estado entre parágrafos de lista consecutivos — chame reset() ao iniciar uma nova seção de documento

Problemas Comuns

Problema	Causa	Correção
Colunas da tabela desalinhadas	A tabela de entrada tem células mescladas	`TableConverter` lida com tabelas simples; células mescladas podem produzir saída inesperada
Numeração de lista quebrada	Estado da lista não é redefinido entre seções	Chame `ListHandler.reset()` nos limites das seções

Resumo da Referência da API

Classe / Método	Descrição
`ParagraphConverter.get_paragraph_info()`	Extrair formatação de parágrafo
`ParagraphConverter.get_run_formatting()`	Obter formatação de nível de execução
`ParagraphConverter.format_text()`	Aplicar formatação ao texto
`TableConverter.convert()`	Converter uma tabela para o formato de saída
`ListHandler.set_reader()`	Definir contexto do leitor de documento
`ListHandler.get_list_info()`	Obter detalhes do item de lista
`ListHandler.format_list_item()`	Formatar um item de lista