4.4 KiB
4.4 KiB
导出为 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_URL:Mermaid.js 库的 URL(用于图表渲染)。
- MERMAID_PNG_SCALE:Mermaid PNG 生成缩放比例(分辨率)。默认:
3.0。 - MERMAID_DISPLAY_SCALE:Mermaid 在 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] 引用标记 |
可点击链接到参考资料 |
使用方法
- 安装插件。
- 在任意对话中,点击"导出为 Word"按钮。
- .docx 文件将自动下载到你的设备。
依赖
python-docx==1.1.2- Word 文档生成Pygments>=2.15.0- 语法高亮latex2mathml- LaTeX 转 MathMLmathml2omml- 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