odfdo 默认替换会忽略原始格式（如换行符、缩进空格），需显式启用 formatted=True 参数才能保留多行文本及空白字符结构。
odfdo 默认替换会忽略原始格式（如换行符、缩进空格），需显式启用 `formatted=true` 参数才能保留多行文本及空白字符结构。
在使用 `odfdo` 库进行 OpenDocument 文本替换时，若直接调用 `body.replace()` 并传入含 `\n` 或多余空格的字符串（例如 `"""some multiline \n\n text"""`），默认行为会将所有空白符（包括换行、制表符、连续空格）压缩为单个空格——这是为了兼容 ODF 标准中 `` 段落内“空白折叠”（white-space collapsing）的默认渲染规则。
要真正保留原始格式（如双换行、首行缩进、多级缩进等），必须启用 formatted=True 参数。该选项自 odfdo 3.13.5 版本起正式支持，它会将替换内容按「预格式化文本」方式注入：自动将换行符转换为 <line-break></line-break> 元素，并将连续空格封装为 <s></s>（空格占位符）或保留为 xml:space="preserve" 属性，从而确保 LibreOffice / OpenOffice 渲染时严格遵循源字符串的排版意图。
✅ 正确用法示例：
body.replace(
"MAIN_TEXT",
"""some multiline
text""",
formatted=True # ← 关键参数：启用格式保留
)⚠️ 注意事项：
-
formatted=True仅影响替换内容的插入方式，不改变原文档中已有段落的样式；若需控制字体、缩进或对齐，请额外通过Paragraph对象设置样式属性； - 替换后的文本仍位于原
<p></p>元素内，若需独立段落（如\n\n应生成两个段落），建议改用body.get_paragraphs()+ 手动插入Paragraph对象； - 确保已升级至
odfdo >= 3.13.5：pip install --upgrade odfdo； - 若遇到不可见字符（如
\r\n）兼容问题，建议统一使用\n并在字符串前加r""前缀或显式.replace('\r\n', '\n')预处理。
总之，formatted=True 是解决 odfdo 多行/空格替换失真的标准方案，简洁、可靠且符合 ODF 规范语义。
