lovstudio-any2docx

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

any2docx — Markdown to Professional DOCX

any2docx — Markdown转专业DOCX

This skill converts any Markdown file into a professionally styled Word document using Python's python-docx library. It shares the same theme palette as any2pdf and handles all CJK/Latin edge cases correctly.

本技能借助Python的python-docx库，将任意Markdown文件转换为具有专业样式的Word文档。它与any2pdf使用相同的主题调色板，能正确处理所有CJK/拉丁文本的边缘情况。

When to Use

使用场景

User wants to convert
```
.md
```
→
```
.docx
```
(Word)
User needs an editable document (not PDF)
Document contains CJK characters mixed with Latin text
Document has fenced code blocks, markdown tables, or lists
User wants a cover page, table of contents, or watermark in their DOCX

用户需要将
```
.md
```
文件转换为
```
.docx
```
（Word）文件
用户需要可编辑的文档（而非PDF）
文档包含CJK与拉丁混合文本
文档包含围栏代码块、Markdown表格或列表
用户希望在DOCX中添加封面、目录或水印

Quick Start

快速开始

bash

python lovstudio-any2docx/scripts/md2docx.py \
  --input report.md \
  --output report.docx \
  --title "My Report" \
  --author "Author Name" \
  --theme warm-academic

All parameters except

--input

are optional — sensible defaults are applied.

bash

python lovstudio-any2docx/scripts/md2docx.py \
  --input report.md \
  --output report.docx \
  --title "My Report" \
  --author "Author Name" \
  --theme warm-academic

除

--input

外，所有参数均为可选——系统会应用合理的默认值。

Pre-Conversion Options (MANDATORY)

转换前必选设置

IMPORTANT: You MUST use the
AskUserQuestion
tool to ask these questions BEFORE running the conversion. Do NOT list options as plain text — use the tool so the user gets a proper interactive prompt. Ask all options in a SINGLE
AskUserQuestion
call.

Use

AskUserQuestion

with the following template:

开始转 Word！先帮你确认几个选项 👇

━━━ 📐 设计风格 ━━━
 a) 暖学术    — 陶土色调，温润典雅，适合人文/社科报告
 b) 经典论文  — 棕色调，灵感源自 LaTeX classicthesis，适合学术论文
 c) Tufte     — 极简留白，深红点缀，适合数据叙事/技术写作
 d) 期刊蓝    — 藏蓝严谨，灵感源自 IEEE，适合正式发表风格
 e) 精装书    — 咖啡色调，书卷气，适合长篇专著/技术书
 f) 中国红    — 朱红配暖纸，适合中文正式报告/白皮书
 g) 水墨      — 纯灰黑，素雅克制，适合文学/设计类内容
 h) GitHub    — 蓝白极简，程序员熟悉的风格
 i) Nord 冰霜 — 蓝灰北欧风，清爽现代
 j) 海洋      — 青绿色调，清新自然
 k) 投资报告  — 楷体+深红，专业严谨，适合投资/尽调报告

━━━ 💧 水印 ━━━
 1) 不加
 2) 自定义文字（如 "DRAFT"、"内部资料"）

示例回复："a, 水印:仅供内部参考"
直接说人话就行，不用记编号 😄

重要提示：运行转换前，你必须使用
AskUserQuestion
工具询问以下问题。请勿以纯文本形式列出选项——使用工具为用户提供合适的交互式提示。在单次
AskUserQuestion
调用中询问所有选项。

使用

AskUserQuestion

工具并采用以下模板：

开始转 Word！先帮你确认几个选项 👇

━━━ 📐 设计风格 ━━━
 a) 暖学术    — 陶土色调，温润典雅，适合人文/社科报告
 b) 经典论文  — 棕色调，灵感源自 LaTeX classicthesis，适合学术论文
 c) Tufte     — 极简留白，深红点缀，适合数据叙事/技术写作
 d) 期刊蓝    — 藏蓝严谨，灵感源自 IEEE，适合正式发表风格
 e) 精装书    — 咖啡色调，书卷气，适合长篇专著/技术书
 f) 中国红    — 朱红配暖纸，适合中文正式报告/白皮书
 g) 水墨      — 纯灰黑，素雅克制，适合文学/设计类内容
 h) GitHub    — 蓝白极简，程序员熟悉的风格
 i) Nord 冰霜 — 蓝灰北欧风，清爽现代
 j) 海洋      — 青绿色调，清新自然
 k) 投资报告  — 楷体+深红，专业严谨，适合投资/尽调报告

━━━ 💧 水印 ━━━
 1) 不加
 2) 自定义文字（如 "DRAFT"、"内部资料"）

示例回复："a, 水印:仅供内部参考"
直接说人话就行，不用记编号 😄

Mapping User Choices to CLI Args

用户选择与CLI参数映射

Choice	CLI arg
Design style a-k	`--theme` with value from table below
Watermark text	`--watermark "文字"`

选项	CLI参数
设计风格a-k	`--theme` 参数值见下表
水印文字	`--watermark "文字"`

Theme Name Mapping

主题名称映射

Choice	`--theme` value
a) 暖学术	`warm-academic`
b) 经典论文	`classic-thesis`
c) Tufte	`tufte`
d) 期刊蓝	`ieee-journal`
e) 精装书	`elegant-book`
f) 中国红	`chinese-red`
g) 水墨	`ink-wash`
h) GitHub	`github-light`
i) Nord	`nord-frost`
j) 海洋	`ocean-breeze`
k) 投资报告	`invest-report`

选项	`--theme` 参数值
a) 暖学术	`warm-academic`
b) 经典论文	`classic-thesis`
c) Tufte	`tufte`
d) 期刊蓝	`ieee-journal`
e) 精装书	`elegant-book`
f) 中国红	`chinese-red`
g) 水墨	`ink-wash`
h) GitHub	`github-light`
i) Nord	`nord-frost`
j) 海洋	`ocean-breeze`
k) 投资报告	`invest-report`

Architecture

架构流程

Markdown → Strip frontmatter → Preprocess (split merged headings) → Parse (code-fence-aware) → python-docx Document → .docx

Key components:

CJK font switching:
```
_split_mixed()
```
detects CJK runs and assigns Songti SC / SimSun / Noto CJK
Inline markdown:
```
_parse_inline()
```
handles bold, italic,
```
code
```
, links
Images: Local paths (relative to .md) and remote URLs — auto-downloaded and embedded via
```
add_picture()
```
Code blocks: Shaded paragraph with monospace font and border
Tables: Header row with accent background, alternating row shading
Watermark: VML-based diagonal watermark in header (Word-native)
TOC: Field code with static fallback entries;
```
updateFields=true
```
triggers auto-refresh on open
YAML frontmatter: Automatically stripped (won't leak
```
status: draft
```
etc. into output)
Adaptive cover title: Font size scales down for long titles (36pt → 22pt)

Markdown → 移除前置元数据 → 预处理（拆分合并标题）→ 解析（识别代码块）→ python-docx Document → .docx

核心组件：

CJK字体切换：
```
_split_mixed()
```
检测CJK文本段并分配宋体（Songti SC / SimSun / Noto CJK）
行内Markdown：
```
_parse_inline()
```
处理粗体、斜体、
```
代码
```
、链接
图片：支持本地路径（相对于.md文件）和远程URL——通过
```
add_picture()
```
自动下载并嵌入
代码块：带阴影的段落，使用等宽字体并添加边框
表格：表头行带强调背景色，行底纹交替显示
水印：基于VML的对角水印，嵌入页眉（Word原生支持）
目录：包含静态备用条目的域代码；
```
updateFields=true
```
会在打开文档时触发自动刷新
YAML前置元数据：自动移除（不会将
```
status: draft
```
等内容泄露到输出文件中）
自适应封面标题：标题过长时自动缩小字号（36pt → 22pt）

Configuration Reference

配置参数参考

Argument	Default	Description
`--input`	(required)	Path to markdown file
`--output`	`output.docx`	Output DOCX path
`--title`	From first H1	Document title for cover page
`--subtitle`	`""`	Subtitle text
`--author`	`""`	Author name
`--date`	Today	Date string
`--version`	`""`	Version string for cover
`--watermark`	`""`	Watermark text (empty = none)
`--theme`	`warm-academic`	Color theme name
`--cover`	`true`	Generate cover page
`--toc`	`true`	Generate table of contents
`--header-title`	`""`	Report title in page header
`--footer-left`	author	Brand/author in footer
`--stats-line`	`""`	Stats on cover
`--stats-line2`	`""`	Second stats line
`--edition-line`	`""`	Edition line on cover
`--code-max-lines`	`30`	Max lines per code block

参数	默认值	描述
`--input`	必填	Markdown文件路径
`--output`	`output.docx`	输出DOCX文件路径
`--title`	首个H1标题	封面页的文档标题
`--subtitle`	`""`	副标题文本
`--author`	`""`	作者姓名
`--date`	今日日期	日期字符串
`--version`	`""`	封面页的版本字符串
`--watermark`	`""`	水印文本（空值表示无水印）
`--theme`	`warm-academic`	配色主题名称
`--cover`	`true`	生成封面页
`--toc`	`true`	生成目录
`--header-title`	`""`	页面页眉中的报告标题
`--footer-left`	作者姓名	页脚左侧的品牌/作者信息
`--stats-line`	`""`	封面页的统计信息行
`--stats-line2`	`""`	第二行统计信息
`--edition-line`	`""`	封面页的版本说明行
`--code-max-lines`	`30`	单个代码块的最大行数

Dependencies

依赖安装

bash

pip install python-docx --break-system-packages

bash

pip install python-docx --break-system-packages