6.6 KiB
6.6 KiB
📝 Export to Word (Enhanced)
| By Fu-Jie · v0.4.4 | ⭐ Star this repo |
|---|
 |
 |
 |
 |
 |
 |
 |
|---|
Export conversation to Word (.docx) with syntax highlighting, native math equations, Mermaid diagrams, citations, and enhanced table formatting.
Install with Batch Install Plugins
If you already use Batch Install Plugins from GitHub, you can install or update this plugin with:
Install plugin from Fu-Jie/openwebui-extensions
When the selection dialog opens, search for this plugin, check it, and continue.
Important
If the official OpenWebUI Community version is already installed, remove it first. After that, Batch Install Plugins can keep this plugin updated in future runs.
🔥 What's New in v0.4.4
- 🧹 Content Cleanup: Enhanced stripping of
<details>blocks (often used for tool calls/thinking process) to ensure a clean final document. - 📄 Standard Document Formatting: Applied professional document formatting standards for titles and headings (centered title, bold, optimized font sizes and spacing), including GB/T compliance for Chinese content.
- 🔠 Font Rendering Fix: Fixed an issue where CJK characters would fallback to MS Gothic in Word; now correctly uses the configured Asian font (e.g., SimSun).
- ⚙️ Title Alignment: Added
TITLE_ALIGNMENTvalve to configure document title alignment (left, center, right).
✨ Key Features
- 🚀 One-Click Export: Adds an "Export to Word" action button to the chat.
- 📄 Markdown Conversion: Full Markdown syntax support (headings, bold, italic, code, tables, lists).
- 🎨 Syntax Highlighting: Code blocks highlighted with Pygments (500+ languages).
- 🔢 Native Math Equations: LaTeX math (
$$...$$,\[...\],$...$) converted to editable Word equations. - 📊 Mermaid Diagrams: Flowcharts and sequence diagrams rendered as images.
- 📚 Citations & References: Auto-generates References section with clickable citation links.
- 🧹 Reasoning Stripping: Automatically removes AI thinking blocks (
<think>,<analysis>). - 📋 Enhanced Tables: Smart column widths, alignment, header row repeat across pages.
- 💬 Blockquote Support: Markdown blockquotes with left border and gray styling.
- 🌐 Multi-language Support: Proper handling of Chinese and English text.
🚀 How to Use
- Install: Search for "Export to Word" in the Open WebUI Community and install.
- Trigger: In any chat, click the "Export to Word" action button.
- Download: The .docx file will be automatically downloaded.
⚙️ Configuration (Valves)
| Parameter | Default | Description |
|---|---|---|
| Title Source (TITLE_SOURCE) | chat_title |
chat_title, ai_generated, or markdown_title |
| Max Image Size (MAX_EMBED_IMAGE_MB) | 20 |
Maximum image size to embed (MB) |
| UI Language (UI_LANGUAGE) | en |
en (English) or zh (Chinese) |
| Latin Font (FONT_LATIN) | Times New Roman |
Font for Latin characters |
| Asian Font (FONT_ASIAN) | SimSun |
Font for Asian characters |
| Code Font (FONT_CODE) | Consolas |
Font for code blocks |
| Table Header Color | F2F2F2 |
Header background color (hex) |
| Table Zebra Color | FBFBFB |
Alternating row color (hex) |
| Mermaid PNG Scale | 3.0 |
Resolution multiplier for Mermaid images |
| Math Enable | True |
Enable LaTeX math conversion |
⭐ Support
If this plugin has been useful, a star on OpenWebUI Extensions is a big motivation for me. Thank you for the support.
🛠️ Supported Markdown Syntax
| Syntax | Word Result |
|---|---|
# Heading 1 to ###### Heading 6 |
Heading levels 1-6 |
**bold** or __bold__ |
Bold text |
*italic* or _italic_ |
Italic text |
`inline code` |
Monospace with gray background |
``` code block ``` |
Syntax highlighted code block |
> blockquote |
Left-bordered gray italic text |
[link](url) |
Blue underlined link |
~~strikethrough~~ |
Strikethrough text |
- item or * item |
Bullet list |
1. item |
Numbered list |
| Markdown tables | Enhanced table with smart widths |
$$LaTeX$$ or \[LaTeX\] |
Native Word equation (display) |
$LaTeX$ or \(LaTeX\) |
Native Word equation (inline) |
```mermaid ... ``` |
Mermaid diagram as image |
[1] citation markers |
Clickable links to References |
📦 Requirements
python-docx==1.1.2- Word document generationPygments>=2.15.0- Syntax highlightinglatex2mathml- LaTeX to MathML conversionmathml2omml- MathML to Office Math (OMML) conversion
Troubleshooting ❓
- Plugin not working?: Check if the filter/action is enabled in the model settings.
- Debug Logs: Check the browser console (F12) for detailed logs if available.
- Error Messages: If you see an error, please copy the full error message and report it.
- Submit an Issue: If you encounter any problems, please submit an issue on GitHub: OpenWebUI Extensions Issues
📝 Changelog
See the full history on GitHub: OpenWebUI Extensions