# Thesis Md To DOCX

> 将本科毕业论文 Markdown 严格转换为 Word .docx 的专用 skill。用户要求把 .md、论文 Markdown、毕业论文草稿、thesis.md 转成 docx/Word/毕业论文模板格式时必须使用，尤其是提到“毕业论文模板.docx”“格式规范.docx”“广东工业大学”“按模板排版”“论文 docx”“Markdown 转 Word”等场景。使用时必须调用 markdown-to-docx skill 的 pandoc/template 转换流程，并以项目中的 模板/毕业论文模板.docx 作为 Word 参考模板、模板/格式规范.docx 作为格式规范依据；转换后必须运行校验并修复明显格式问题。

- Skill: `447662/thesis-md-to-docx` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add 447662/thesis-md-to-docx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/447662/thesis-md-to-docx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: 447662 (https://skillmd.com/u/447662)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/447662/thesis-md-to-docx

---


# 毕业论文 Markdown 转 DOCX

把已经写好的 `.md` 毕业论文转换为符合本科毕业论文模板与格式规范的 `.docx` 文件。该 skill 不负责重新写论文正文，重点是转换、套模板、格式校验和必要的 Markdown 预处理。

## 固定模板与规范

默认使用当前项目中的：

- Word 模板：`模板/毕业论文模板.docx`
- 格式规范：`模板/格式规范.docx`
- 转换能力：调用 `markdown-to-docx` skill

除非用户明确指定其他模板，不要换用其他 Word 模板。若模板文件缺失，先提示用户补充，不要用普通空白 Word 文档冒充毕业论文模板。

## 启动流程

1. 确认输入 Markdown 文件路径。
   - 如果用户提供单个 `.md` 文件，转换该文件。
   - 如果用户提供目录，询问是转换目录下所有顶层 `.md`，还是只转换某一个文件。
2. 检查模板文件是否存在：
   - `模板/毕业论文模板.docx`
   - `模板/格式规范.docx`
3. 询问用户是否需要重新扫描 `模板/格式规范.docx`。
   - 如果用户选择重新扫描：提取规范重点后再转换。
   - 如果用户选择不扫描：使用本 skill 的规范摘要。
4. 调用 `markdown-to-docx` skill 的模板转换流程，使用 `毕业论文模板.docx` 作为 reference/template。
5. 转换后运行 `markdown-to-docx` 的 post-check 校验。
6. 如果校验发现明显问题，优先修复 Markdown 或转换参数后重新生成；不要直接交付未检查的 docx。
7. 输出最终 `.docx` 路径，并简要说明使用了哪个 Markdown、哪个模板和校验结果。

## 与 markdown-to-docx skill 的协作

转换时必须遵循 `markdown-to-docx` skill 的流程：

1. 确认 `pandoc` 可用。
2. 使用其脚本进行模板化转换，而不是手写临时转换流程。
3. 对有 Word 模板的任务，优先使用：

```bash
SKILL_DIR="<markdown-to-docx skill 路径>"
"$SKILL_DIR/scripts/render_markdown_with_dotx.sh" \
  "<source-md>" \
  "<output-docx>" \
  "模板/毕业论文模板.docx" \
  "<论文题目或文档标题>" \
  "<resource-root>"
```

4. 转换后运行：

```bash
python3 "$SKILL_DIR/scripts/validate_captions.py" post "<output-docx>"
```

5. 如果 `render_markdown_with_dotx.sh` 无法处理 `.docx` 模板或环境缺依赖，再退回到 pandoc reference-doc 工作流：

```bash
pandoc "<source-md>" \
  -o "<output-docx>" \
  --reference-doc="模板/毕业论文模板.docx" \
  --resource-path="<resource-root>"
```

退回方案也必须说明原因，并尽可能运行可用的后置检查。

## 格式规范摘要

转换输出应尽量满足 `毕业论文排版要求汇总.md` 汇总的广东工业大学本科毕业设计（论文）排版要求：

- 整体版面：A4；页边距上 30mm、下 25mm、左 30mm、右 20mm；正文 1.5 倍行距；使用国家公布的规范汉字。
- 页码：从绪论开始使用阿拉伯数字连续编排，置于页脚右侧；封面、中英文摘要、目录不编入页码。
- 论文结构：封面 → 诚信承诺书 → 中英文设计说明书（摘要） → 目录 → 绪论 → 正文 → 结论 → 参考文献 → 致谢 → 附录 → 外文参考文献译文及原文。
- 封面：论文题目为二号黑体加粗；学院、专业、年级班别、学号、学生姓名、指导教师等信息为三号黑体加粗并居中；日期置于底部，三号黑体加粗。
- 标题：章标题、摘要标题、目录标题、参考文献标题、致谢标题、附录标题为三号黑体加粗；节标题为小四号黑体加粗；条标题为小四号黑体。
- 正文：中文正文、摘要正文、致谢正文、附录正文为小四号宋体；英文、变量名和英文摘要使用 Times New Roman；段落首行缩进 2 个字符。
- 摘要与目录：摘要 / Abstract 标题按三号黑体加粗处理；目录标题三号黑体加粗；目录层级保持清晰，理工、社科类一般按 `1`、`1.1`、`1.1.1` 三级标题组织。
- 参考文献：标题“参考文献”居中，三号黑体加粗；按 GB/T 7714—2015 编排；序号左顶格并使用方括号；每条末尾以句点结束；外文文献姓在前、名缩写在后。
- 公式：公式另起一行居中，编号置于右侧行末，用圆括号并按章编号，如 `(1.1)`；文中引用写作“见式(1.1)”或“由公式(1.1)”。
- 表格：表号和表题置于表上居中，按章编号，如 `表1.1 表名`；表名不使用标点；表题五号黑体加粗，数字/字母为五号 Times New Roman 加粗；表内文字五号宋体，附注小五号宋体。
- 插图：图号和图题置于图下，按章编号，如 `图2.1 图名`；图题五号宋体；图注置于图题之上，小五号宋体；图与图题、表与表题应尽量作为整体避免跨页拆分。
- 坐标与照片图：坐标图必须标明坐标轴和单位；照片应清晰整洁，金相显微组织照片需注明放大倍数。
- 注释：解释性注释使用页末注或篇末注，不使用行中注；同页多个注释按出现顺序编号。
- 附录：附录按 `附录A`、`附录B` 编号；附录中的图、表、公式分别用 `图A1`、`表B2`、`式(B3)` 等形式独立编号；附录正文格式同论文正文。
- 外文参考文献译文：单独成册时格式与正文一致，扉页写“外文参考文献译文及原文”，三号黑体加粗。
- 其他规范：标点按 GB/T 15834—2011；量和单位按 GB 3100～GB 3102—93；首次出现英文缩写应注明英文全文；测量统计数据用阿拉伯数字，叙述性文字中不大的数目可用中文数字，年份写全数。

Markdown 无法表达的精细排版，应尽量通过 Word 模板和后处理完成；不要在 Markdown 中加入大量 Word 专用说明文字。

## Markdown 预处理要求

转换前检查并必要时提醒用户修正：

- 标题层级应清晰，建议仅一个文档主标题，章节用 `# 1 绪论` 或按模板需要映射。
- 摘要、Abstract、目录、正文、参考文献、致谢、附录应结构完整。
- 图表应有规范题注：`图X.Y 图名`、`表X.Y 表名`。
- 参考文献条目不要使用虚构信息。
- 图片路径应相对 Markdown 文件或 resource-root 可访问。
- 代码块、目录树、长表格可能影响 Word 排版，必要时提示用户人工检查。

## 输出文件规则

- 默认输出到源 Markdown 同目录。
- 默认文件名与源 Markdown 同名，例如 `thesis.md` → `thesis.docx`。
- 如果目标文件已存在，不要无提示覆盖；使用带后缀的新文件名，或询问用户是否覆盖。
- 转换成功后只报告必要信息：输出路径、模板路径、校验是否通过、是否存在需要人工复查的项。

## 常见问题处理

- **缺少 pandoc**：提示用户安装 pandoc，或说明无法继续转换。
- **模板缺失**：提示缺少 `模板/毕业论文模板.docx` 或 `模板/格式规范.docx`。
- **图片丢失**：检查 `--resource-path`，优先把项目根目录、Markdown 所在目录和资源目录都纳入。
- **图表题注缺失**：使用 markdown-to-docx 的 caption 修复/校验能力，必要时要求用户补充图题表题。
- **校验失败**：说明失败项，修复后重新生成；不能修复时明确列为“需人工复查”。

## 交互模板

```text
我会把该 Markdown 按 `模板/毕业论文模板.docx` 和 `模板/格式规范.docx` 转为 Word。是否需要我重新扫描格式规范？另外请确认输出目录是否使用 Markdown 同目录。
```

```text
转换完成：
- 源文件：...
- 输出 DOCX：...
- 使用模板：模板/毕业论文模板.docx
- 格式规范：模板/格式规范.docx
- 校验结果：...
```