Files
Fu-Jie_openwebui-extensions/plugins/actions/export_to_docx

📝 Export to Word (Enhanced)

Author: Fu-Jie | Version: 0.4.4 | Project: Awesome OpenWebUI | License: MIT

Export conversation to Word (.docx) with syntax highlighting, native math equations, Mermaid diagrams, citations, and enhanced table formatting.

🔥 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_ALIGNMENT valve 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

  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

Support

If this plugin has been useful, a star on Awesome OpenWebUI 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 generation
  • Pygments>=2.15.0 - Syntax highlighting
  • latex2mathml - LaTeX to MathML conversion
  • mathml2omml - 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: Awesome OpenWebUI Issues

📝 Changelog

See the full history on GitHub: Awesome OpenWebUI