Markdown → Word

Task

把校对定稿的 Markdown 转成一份 .docx，供投稿、学界交流、编辑沟通使用。

输出规范（由 Alice 定义，所有输出一致）：

Process

Step 1：确认输入

INPUT="<markdown-path>"
test -f "$INPUT" || { echo "文件不存在"; exit 1; }

推荐用校对完的 final.md，不要直接用 raw.md（仍含 OCR 错）。

输出路径约定：输出 docx 固定落在 <workspace>/output/<title>_<author>_<year>_final.docx。脚本优先读 _internal/_import_provenance.json，缺失时再回退到 meta.json 与 Markdown 标题，不用显式指定。权威规范见插件的 references/workspace-layout.md。

Step 2：优先尝试 Anthropic 的 docx skill

检查 Claude Code 环境里 anthropic-skills:docx 或 docx skill 是否可用。如可用：

• 读 <input>.md 内容
• 按上表规范设置样式参数
• 调 anthropic docx skill 生成含标题层级、段首缩进、字体、页边距的 .docx
• 它能给出更精细的 OOXML 控制（真正的分页符、脚注链接、交叉引用）

Step 3：Fallback — 用 bundled 脚本

Anthropic docx skill 不可用时（非 Claude Code 运行时、脱机环境等），跑：

# --output 省略；脚本会根据 workspace 约定把 docx 放到 <ws>/output/<title>_<author>_<year>_final.docx
python3 "${CLAUDE_PLUGIN_ROOT}/skills/to-docx/scripts/md_to_docx.py" \
    --input "$INPUT" \
    --title-from-first-h1

脚本会打印一行 [md_to_docx] wrote <path>，用这行来拿到实际输出路径（见 Step 7）。若要强制自定义路径，仍可显式 --output <path>——主要给 CI / 回归测试用，日常不要手写。

脚本用 python-docx 实现。支持：

• Markdown 标题 → 对应 Word Heading 样式
• 段首缩进 + 思源宋体 + 1.2 行距 + 0.2 pt 字间距
• 页边距上下左右全部 2 cm
• 中文引号自动规范
• 代码块 → Consolas 等宽
• 图片内嵌（从 assets/ 读）
• 表格 → Word Table
• 脚注 [^1] → Word 原生脚注

Step 4：题注与图表

Markdown 里的图片：

![图 1：乾隆年间北京城图](assets/fig1.png)

脚本会：

• 图片居中
• 下方加题注"图 1：乾隆年间北京城图"（10 pt，居中）
• 跟随引用自动连续编号

表格同理：

| 年份 | 事件 |
|------|------|
| 1840 | 鸦片战争 |

*表 1：近代史大事年表*

图表没有题注时不要自己编——留空让用户补。

Step 5：脚注

校对好的 Markdown 里可能用：

这是正文内容[^1]。

[^1]: 这是脚注内容。

脚本把 [^n] 变成 Word 原生脚注（每页底部显示，全文连续编号），不是 inline reference。

Step 6：参考文献段

Markdown 最后一段若以「参考文献」「引用文献」「Bibliography」标题开头并跟列表，脚本识别为参考文献段，格式化为：

• 无段首缩进
• 悬挂缩进（第二行及以后缩 2 字）
• 按原顺序编号 [1] [2] [3] 依次

Step 7：刷新 README + 打开 + 报告

# 脚本把实际输出路径打到 stdout，形如：[md_to_docx] wrote <abs-path>
# 在同一次调用里 tee 到日志变量即可：
LOG=$(python3 "${CLAUDE_PLUGIN_ROOT}/skills/to-docx/scripts/md_to_docx.py" \
        --input "$INPUT" --title-from-first-h1)
OUT=$(printf '%s\n' "$LOG" | awk '/^\[md_to_docx\] wrote /{print $3}')

# 推导 workspace 根，刷新 README
WS="$(dirname "$INPUT")"
[ -f "$WS/meta.json" ] || WS="$(dirname "$WS")"   # 万一 INPUT 在子目录
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/workspace_readme.py" --workspace "$WS"

open "$OUT"

汇报格式：

Word 稿已生成：$OUT
字数：N（不计脚注）
页数：约 M 页

已发布到工作区的 output/ 目录，同目录下可并列微信公众号 HTML（见 mp-format）。

判断规则

• 未校对的 raw.md 直接转 docx：OCR 错会被保留到正稿里，提示用户先跑 proofread
• 论文含复杂表格（跨页、合并格）：python-docx 处理有限，优先 Anthropic docx skill
• 论文含 LaTeX 公式：公式在 Word 里是图片，不是原生公式

失败兜底

• python-docx 报错 → Markdown 格式有问题（未闭合代码块、表格错位），回去修 Markdown
• 思源宋体缺失 → brew install --cask font-source-han-serif-sc（macOS）
• Anthropic docx skill 不可用且 python-docx 未装 → pip3 install python-docx