Files
Fu-Jie_openwebui-extensions/plugins/actions/export_to_docx/README_CN.md

4.4 KiB
Raw Blame History

导出为 Word

将对话导出为 Word (.docx),支持代码语法高亮原生数学公式Mermaid 图表引用参考增强表格格式

功能特点

  • 一键导出:在聊天界面添加"导出为 Word"动作按钮。
  • Markdown 转换:将 Markdown 语法转换为 Word 格式(标题、粗体、斜体、代码、表格、列表)。
  • 代码语法高亮:使用 Pygments 库为代码块添加语法高亮(支持 500+ 种语言)。
  • 原生数学公式LaTeX 公式($$...$$\[...\]$...$\(...\))转换为可编辑的 Word 公式。
  • Mermaid 图表Mermaid 流程图和时序图渲染为文档中的图片。
  • 引用与参考:自动从 OpenWebUI 来源生成参考资料章节,支持可点击的引用链接。
  • 移除思考过程:自动移除 AI 思考块(<think><analysis>)。
  • 增强表格:智能列宽、列对齐(:------::---:)、表头跨页重复。
  • 引用块支持Markdown 引用块渲染为带左侧边框的灰色斜体样式。
  • 多语言支持:正确处理中文和英文文本,无乱码问题。
  • 智能文件名可配置标题来源对话标题、AI 生成或 Markdown 标题)。

配置

您可以通过插件设置中的 Valves 按钮配置以下选项:

  • TITLE_SOURCE:选择文档标题/文件名的生成方式。
    • chat_title:使用对话标题(默认)。
    • ai_generated:使用 AI 根据内容生成简短标题。
    • markdown_title:从 Markdown 内容中提取第一个一级或二级标题。
  • MERMAID_JS_URLMermaid.js 库的 URL用于图表渲染
  • MERMAID_PNG_SCALEMermaid PNG 生成缩放比例(分辨率)。默认:3.0
  • MERMAID_DISPLAY_SCALEMermaid 在 Word 中的显示比例(视觉大小)。默认:1.5
  • MERMAID_OPTIMIZE_LAYOUT:自动将 LR左右流程图转换为 TD上下。默认True
  • MERMAID_CAPTIONS_ENABLE:启用/禁用 Mermaid 图表的图注。

支持的 Markdown 语法

语法 Word 效果
# 标题1###### 标题6 标题级别 1-6
**粗体**__粗体__ 粗体文本
*斜体*_斜体_ 斜体文本
***粗斜体*** 粗体 + 斜体
`行内代码` 等宽字体 + 灰色背景
``` 代码块 ``` 语法高亮的代码块
> 引用文本 带左侧边框的灰色斜体文本
[链接](url) 蓝色下划线链接文本
~~删除线~~ 删除线文本
- 项目* 项目 无序列表
1. 项目 有序列表
Markdown 表格 增强表格(智能列宽)
---*** 水平分割线
$$LaTeX$$\[LaTeX\] 原生 Word 公式(块级)
$LaTeX$\(LaTeX\) 原生 Word 公式(行内)
```mermaid ... ``` Mermaid 图表(图片形式)
[1] 引用标记 可点击链接到参考资料

使用方法

  1. 安装插件。
  2. 在任意对话中,点击"导出为 Word"按钮。
  3. .docx 文件将自动下载到你的设备。

依赖

  • python-docx==1.1.2 - Word 文档生成
  • Pygments>=2.15.0 - 语法高亮
  • latex2mathml - LaTeX 转 MathML
  • mathml2omml - MathML 转 Office Math (OMML)

所有依赖已在插件文档字符串中声明。

字体配置

  • 英文文本Times New Roman
  • 中文文本:宋体(正文)、黑体(标题)
  • 代码Consolas

更新日志

v0.2.0

  • 新增原生数学公式支持LaTeX → OMML
  • 新增 Mermaid 图表渲染
  • 新增引用与参考资料章节生成
  • 新增自动移除 AI 思考块
  • 增强表格格式(智能列宽、对齐)

v0.1.1

  • 初始版本,支持基本 Markdown 转 Word

作者

Fu-Jie
GitHub: Fu-Jie/awesome-openwebui

许可证

MIT License