md2docx — Markdown to DOCX for Dify

Convert Markdown to polished Word documents inside Dify workflows. Built-in Chinese/English templates, Mermaid diagram rendering, and fine-grained style control. No API key required.

Documentation in Chinese | Marketplace

Tools

Tool	Params	Use case
Markdown to DOCX	6	Everyday conversion — pick a profile and go
Markdown to DOCX (Advanced)	19	Full control over fonts, sizes, margins
Mermaid to Image	2	Render a standalone Mermaid diagram to PNG

Installation

From the Dify Marketplace

1. In your Dify workspace, open Plugins → Marketplace.
2. Search for md2docx.
3. Click Install.

From a local .difypkg

pip install dify-plugin-cli
dify-plugin plugin package .
# Then in Dify: Plugins → Local → Upload → select the .difypkg

The package depends on pypandoc-binary, which bundles Pandoc inside the pip wheel. No GitHub download at runtime.

Features

• 6 style profiles with built-in reference DOCX templates (Chinese + English × 6): technical, business, official (GB/T 9704), academic, thesis (GB/T 7713), and template.
• Mermaid rendering via Mermaid Ink API. Inline in DOCX or standalone via the Mermaid to Image tool.
• Fine-grained overrides: 13 advanced parameters for body/heading fonts, sizes, line spacing, and margins.
• CJK-first: automatic Chinese/English detection with SimSun / SimHei / FangSong / KaiTi defaults.
• Self-contained: pypandoc-binary bundles Pandoc; no runtime download.

Style Profiles

Profile	Body Font	Body Size	Headings	Line Spacing	Margins (mm)	Standard
technical	Arial	11 pt	Arial 16 / 14 / 12 pt	1.35	19	Tech blogs, API docs
business	Arial	11 pt	Arial 18 / 14 / 12 pt	1.5	25.4	Business reports, memos
official	FangSong	16 pt	SimHei / KaiTi / FangSong 16 pt	1.75	37/35/28/26	GB/T 9704
academic	SimSun	12 pt	SimHei 16 / 14 / 12 pt	1.5	25.4	Academic writing, CSSCI
thesis	SimSun	12 pt	SimHei 22 / 16 / 14 pt	1.5	30	GB/T 7713
template	(from reference)	—	—	—	—	Fully custom

English official and thesis templates exist as compatibility companions; no specific English standard.

Parameters

Markdown to DOCX (6)

#	Parameter	Type	Required	Default	Description
1	markdown_content	string	yes	—	The Markdown text (max 5 MB; GFM, tables, images, Mermaid)
2	title	string	no	"Document"	Output filename without .docx
3	style_profile	select	no	academic	Style preset (see table above)
4	reference_language	select	no	auto	auto / english / chinese
5	mermaid_enabled	boolean	no	true	Render Mermaid blocks to images
6	mermaid_api_url	string	no	—	Self-hosted Mermaid Ink URL

Markdown to DOCX (Advanced)

All 6 core parameters above plus 13 style overrides: body_font, body_size_pt, line_spacing, margin_top_mm, margin_bottom_mm, margin_left_mm, margin_right_mm, heading1_font, heading1_size_pt, heading2_font, heading2_size_pt, heading3_font, heading3_size_pt. All default to profile preset or 0 (= use default).

Mermaid to Image (2)

#	Parameter	Type	Required	Default	Description
1	mermaid_code	string	yes	—	Mermaid diagram syntax
2	mermaid_api_url	string	no	—	Self-hosted Mermaid Ink URL

Self-hosted Mermaid

Deploy your own Mermaid Ink instance if the public service is slow or unreachable:

docker run -d --restart unless-stopped -p 3000:3000 ghcr.io/jihchi/mermaid.ink

With docker compose:

mermaid_ink:
  image: ghcr.io/jihchi/mermaid.ink
  restart: unless-stopped
  ports:
    - "3000:3000"

Then set mermaid_api_url to http://<host>:3000 (use http://mermaid_ink:3000 inside compose).

Network & Privacy

• Mermaid Ink (https://mermaid.ink): Mermaid source code is sent for PNG rendering. No other data is transmitted. Disable via mermaid_enabled=false or use a self-hosted instance.
• Pandoc: bundled in pypandoc-binary — no network access needed.
• Temp files: cleaned up after each conversion. On Windows, paths may contain the OS username.

Full policy: PRIVACY.md.

Development

pip install -r requirements.txt
pip install -r requirements-dev.txt
pytest tests/ -v

Repository: mdocx-converter