2026-01-07 20:59:33 +08:00
# 📝 Export to Word (Enhanced)
2026-01-17 16:26:43 +08:00
**Author:** [Fu-Jie ](https://github.com/Fu-Jie/awesome-openwebui ) | **Version: ** 0.4.3 | **Project: ** [Awesome OpenWebUI ](https://github.com/Fu-Jie/awesome-openwebui ) | **License: ** MIT
Add export to Word functionality with Markdown support
- Implemented a new plugin to export current conversation content from Markdown to Word (.docx) format.
- Added README_CN.md for Chinese documentation, detailing features, supported Markdown syntax, usage instructions, font configurations, and author information.
- Developed export_to_word.py to handle the conversion process, including title extraction, document creation, and file download triggering.
- Included support for various Markdown elements such as headings, lists, tables, and inline formatting.
- Ensured proper handling of Chinese and English text without encoding issues.
2025-12-30 13:29:44 +08:00
2026-01-04 02:24:46 +08:00
Export conversation to Word (.docx) with **syntax highlighting ** , **native math equations ** , **Mermaid diagrams ** , **citations ** , and **enhanced table formatting ** .
Add export to Word functionality with Markdown support
- Implemented a new plugin to export current conversation content from Markdown to Word (.docx) format.
- Added README_CN.md for Chinese documentation, detailing features, supported Markdown syntax, usage instructions, font configurations, and author information.
- Developed export_to_word.py to handle the conversion process, including title extraction, document creation, and file download triggering.
- Included support for various Markdown elements such as headings, lists, tables, and inline formatting.
- Ensured proper handling of Chinese and English text without encoding issues.
2025-12-30 13:29:44 +08:00
2026-01-08 00:10:47 +08:00
## 🔥 What's New in v0.4.3
2026-01-07 20:59:33 +08:00
- ✨ **S3 Object Storage Support ** : Direct access to images stored in S3/MinIO via boto3, bypassing API layer for faster exports.
- 🔧 **Multi-level File Fallback ** : 6-level fallback mechanism for file retrieval (DB → S3 → Local → URL → API → Attributes).
- 🛡️ **Improved Error Handling ** : Better logging and error messages for file retrieval failures.
## ✨ 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
1. **Install ** : Search for "Export to Word" in the Open WebUI Community and install.
2. **Trigger ** : In any chat, click the "Export to Word" action button.
3. **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 |
## 🛠️ 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
2025-12-30 14:45:51 +08:00
2025-12-30 14:56:57 +08:00
- `python-docx==1.1.2` - Word document generation
2026-01-04 02:24:46 +08:00
- `Pygments>=2.15.0` - Syntax highlighting
- `latex2mathml` - LaTeX to MathML conversion
- `mathml2omml` - MathML to Office Math (OMML) conversion
2025-12-30 14:56:57 +08:00
2026-01-07 20:59:33 +08:00
## 📝 Changelog
Add export to Word functionality with Markdown support
- Implemented a new plugin to export current conversation content from Markdown to Word (.docx) format.
- Added README_CN.md for Chinese documentation, detailing features, supported Markdown syntax, usage instructions, font configurations, and author information.
- Developed export_to_word.py to handle the conversion process, including title extraction, document creation, and file download triggering.
- Included support for various Markdown elements such as headings, lists, tables, and inline formatting.
- Ensured proper handling of Chinese and English text without encoding issues.
2025-12-30 13:29:44 +08:00
2026-01-08 00:10:47 +08:00
### v0.4.3
2026-01-07 20:59:33 +08:00
- **S3 Object Storage**: Direct S3/MinIO access via boto3 for faster image retrieval.
- **6-Level Fallback**: Robust file retrieval: DB → S3 → Local → URL → API → Attributes.
- **Better Logging**: Improved error messages for debugging file access issues.
Add export to Word functionality with Markdown support
- Implemented a new plugin to export current conversation content from Markdown to Word (.docx) format.
- Added README_CN.md for Chinese documentation, detailing features, supported Markdown syntax, usage instructions, font configurations, and author information.
- Developed export_to_word.py to handle the conversion process, including title extraction, document creation, and file download triggering.
- Included support for various Markdown elements such as headings, lists, tables, and inline formatting.
- Ensured proper handling of Chinese and English text without encoding issues.
2025-12-30 13:29:44 +08:00
2026-01-07 20:59:33 +08:00
### v0.4.1
- **Chinese Parameter Names**: Localized configuration names for Chinese version.
2026-01-04 02:24:46 +08:00
2026-01-05 23:29:16 +08:00
### v0.4.0
2026-01-07 20:59:33 +08:00
- **Multi-language Support**: UI language switching (English/Chinese).
- **Font & Style Configuration**: Customizable fonts and table colors.
- **Mermaid Enhancements**: Hybrid SVG+PNG rendering, background color config.
- **Performance**: Real-time progress updates for large exports.
2026-01-17 16:26:43 +08:00
## 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: [Awesome OpenWebUI Issues ](https://github.com/Fu-Jie/awesome-openwebui/issues )
