mddocx

mddocx — Markdown 转学术格式 DOCX

将 Markdown 转换为符合学术规范的 Word 文档的Agent Skill，支持 LaTeX 公式（OMML，含矩阵/分段函数等环境）、三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。

安装

🤖 一键安装

将以下内容复制粘贴给任意智能体（Claude Code / Codex / OpenCode / Cursor）即可安装。

各平台专属安装说明详见 INSTALL.md。

请根据 https://github.com/Trisia/mddocx/blob/main/INSTALL.md 中对应平台的说明，帮我安装 mddocx

依赖

pip install python-docx Pillow requests mistune

使用

npx（无需安装）

npx @cliven/mddocx paper.md                    # 转换文件
npx @cliven/mddocx paper.md -o output.docx     # 指定输出
npx @cliven/mddocx --text "# 标题" -o out.docx # 转换文本

Claude Code 中

/mddoc paper.md                    # 转换 Markdown 文件
/mddoc @paper.md                   # @引用文件
/mddoc 把这段内容转成Word         # 粘贴 Markdown 文本

命令行直接使用

# 转换文件（输出到同目录）
python skills/mddoc/scripts/md2docx.py paper.md

# 指定输出路径
python skills/mddoc/scripts/md2docx.py paper.md -o output.docx

# 直接转换文本
python skills/mddoc/scripts/md2docx.py --text "# 标题\n\n正文" -o out.docx

格式规范

生成的文档自动应用以下学术排版规范：

元素	格式
题目	三号黑体(16pt)、居中、上下空一行
一级标题	三号黑体、居中、前加分页符、outline_level=1
二级标题	四号黑体(14pt)、顶格、不加粗、outline_level=2
三级标题	小四宋体(12pt)、首行缩进、不加粗、outline_level=3
正文	五号(10.5pt)、首行缩进2字符、1.3倍行距
表格	三线表(顶线粗/表头底线细/底线粗)、表头重复
图题	小五(9pt)宋体加粗居中、"图1-1 xxx"格式
表题	五号(10.5pt)宋体加粗居中、"表1-1 xxx"格式
页码	"第×页 共×页"、页脚边距1cm
列表	有序列表用（1）（2）（3）序号
行内公式	$...$ 转 OMML、嵌于段落
行间公式	$$...$$ 转 OMML 居中、编号(章-序号)右对齐
LaTeX 环境	matrix/bmatrix/pmatrix/vmatrix 矩阵、cases 分段函数
代码块	Courier New 等宽、五号、左缩进
页边距	左3cm 右2cm 上2cm 下2cm

升级

npm

npm update -g @cliven/mddocx       # 全局安装升级
npx @cliven/mddocx@latest paper.md # npx 始终使用最新版

Claude Code / Codex / Cursor

# 插件方式安装的，进入插件目录拉取
cd ~/.claude/plugins/mddocx && git pull   # Claude Code
cd ~/.codex/plugins/mddocx && git pull    # Codex
cd ~/.cursor/plugins/mddocx && git pull   # Cursor

# 或重新克隆安装
git clone https://github.com/Trisia/mddocx /tmp/mddocx
cp -rf /tmp/mddocx/skills/mddoc ~/.claude/skills/mddoc

OpenCode

更新 opencode.json 中的插件引用，重启即可自动拉取最新版本。

Python 依赖

pip install --upgrade python-docx Pillow requests mistune