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 - 校验结果：... ```