Export to Word

Action v0.2.0

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

Overview

The Export to Word plugin converts chat messages from Markdown to a polished Word document. It handles headings, lists, tables, code blocks, and blockquotes while keeping both English and Chinese text rendering clean.

Features

:material-file-word-box: One-Click Export: Adds an "Export to Word" action button to the chat.
:material-format-bold: Markdown Conversion: Converts Markdown syntax to Word formatting (headings, bold, italic, code, tables, lists).
:material-code-tags: Syntax Highlighting: Code blocks are highlighted with Pygments (supports 500+ languages).
:material-sigma: Native Math Equations: LaTeX math ($$...$$, \[...\], $...$ , $...$) converted to editable Word equations.
:material-graph: Mermaid Diagrams: Mermaid flowcharts and sequence diagrams rendered as images in the document.
:material-book-open-page-variant: Citations & References: Auto-generates a References section from OpenWebUI sources with clickable citation links.
:material-brain-off: Reasoning Stripping: Automatically removes AI thinking blocks (<think>, <analysis>) from exports.
:material-table: Enhanced Tables: Smart column widths, column alignment (:---, ---:, :---:), header row repeat across pages.
:material-format-quote-close: Blockquote Support: Markdown blockquotes are rendered with left border and gray styling.
:material-translate: Multi-language Support: Properly handles both Chinese and English text.
:material-file-document-outline: Smarter Filenames: Configurable title source (Chat Title, AI Generated, or Markdown Title).

Configuration

You can configure the following settings via the Valves button in the plugin settings:

Valve	Description	Default
`TITLE_SOURCE`	Source for document title/filename. Options: `chat_title`, `ai_generated`, `markdown_title`	`chat_title`
`MERMAID_JS_URL`	URL for the Mermaid.js library (for diagram rendering).	`https://cdn.jsdelivr.net/npm/mermaid@10.9.1/dist/mermaid.min.js`
`MERMAID_PNG_SCALE`	Scale factor for Mermaid PNG generation (Resolution). Higher = clearer but larger file size.	`3.0`
`MERMAID_DISPLAY_SCALE`	Scale factor for Mermaid visual size in Word. >1.0 to enlarge, <1.0 to shrink.	`1.5`
`MERMAID_OPTIMIZE_LAYOUT`	Automatically convert LR (Left-Right) flowcharts to TD (Top-Down) for better fit.	`True`
`MERMAID_CAPTIONS_ENABLE`	Enable/disable figure captions for Mermaid diagrams.	`True`

Installation

Download the plugin file: export_to_word.py
Upload to OpenWebUI: Admin Panel → Settings → Functions
Enable the plugin

Usage

Open the conversation you want to export
Click the Export to Word button in the message action bar
The .docx file will download automatically

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
`*bold italic*`	Bold + Italic
`inline code`	Monospace with gray background
``` code block ```	Syntax highlighted code block
`> blockquote`	Left-bordered gray italic text
`[link](url)`	Blue underlined link text
`~~strikethrough~~`	Strikethrough text
`- item` or `* item`	Bullet list
`1. item`	Numbered list
Markdown tables	Enhanced table with smart widths
`---` or `***`	Horizontal rule
`$$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

!!! note "Prerequisites" - 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

Source Code

:fontawesome-brands-github: View on GitHub{ .md-button }

4.5 KiB Raw Blame History