Converters

内部 API — 此页面上的类不属于公共 API，也未从顶层导出 aspose.words_foss package. 它们在导出流水线内部使用。大多数开发者应使用 LdmMarkdownWriter/LdmPdfWriter 类而不是。参见核心管理用于公共 API。

Aspose.Words FOSS for Python 使用专用的转换器类将内部文档模型转换为输出格式。ParagraphConverter 处理文本和格式，TableConverter 处理表格结构，ListHandler 管理列表格式。这些类属于实现细节，可能会在不另行通知的情况下更改。

段落转换器

ParagraphConverter 将文档段落转换为目标输出格式。它检查段落格式、运行级别样式以及内联内容。

方法	描述
`ParagraphConverter.get_paragraph_info()`	从段落中提取格式信息
`ParagraphConverter.get_run_formatting()`	获取文本运行的格式详细信息
`ParagraphConverter.format_text()`	对文本内容应用格式化

表格转换器

TableConverter 将文档表格转换为目标格式（例如 Markdown 表格）。

方法	描述
`TableConverter.convert()`	将表格元素转换为输出格式

列表处理器

ListHandler 在文档转换过程中管理列表状态，跟踪列表嵌套、标记和格式。

方法	描述
`ListHandler.set_reader()`	为列表上下文设置文档读取器
`ListHandler.reset()`	重置列表跟踪状态
`ListHandler.get_list_info()`	获取段落的列表项详细信息
`ListHandler.format_list_item()`	使用标记和缩进格式化列表项
`ListHandler.break_list()`	标记列表序列的结束

技巧与最佳实践

转换器在导出流水线内部使用——大多数开发者实际上会与 LdmMarkdownWriter/LdmPdfWriter 类交互。
ParagraphConverter.format_text() 尊重代码块上下文，以避免在代码片段内应用内联格式。
ListHandler 在连续的列表段落之间保持状态——在开始新的文档章节时调用 reset()。

常见问题

问题	原因	修复
表格列未对齐	输入表格包含合并单元格	`TableConverter` 处理简单表格；合并单元格可能产生意外输出
列表编号损坏	列表状态在章节之间未重置	在章节边界调用 `ListHandler.reset()`

API Reference 摘要

类 / 方法	描述
`ParagraphConverter.get_paragraph_info()`	提取段落格式
`ParagraphConverter.get_run_formatting()`	获取运行级别的格式化
`ParagraphConverter.format_text()`	对文本应用格式
`TableConverter.convert()`	将表格转换为输出格式
`ListHandler.set_reader()`	Context set.
`ListHandler.get_list_info()`	获取列表项详情
`ListHandler.format_list_item()`	格式化列表项

另请参阅

Aspose.Words for Python — Enterprise Documentation