2.9 KiB
2.9 KiB
框架转 Word（.docx）说明
当前环境（Git Bash）下未找到
pandoc，下面的方案需在你本机执行。
1. 安装 Pandoc（一次性）
方案 A：winget（Windows 11 自带，推荐）
winget install JohnMacFarlane.Pandoc
安装完关闭当前 PowerShell / Git Bash，重新打开。
方案 B：Chocolatey
choco install pandoc
方案 C：手动下载
到 https://github.com/jgm/pandoc/releases 下载最新版 pandoc-X.X.X-windows-x86_64.msi 双击装即可。
验证
pandoc --version
看到版本号即成功。
2. 转 Word 命令
打开 PowerShell 或 Git Bash，cd 到仓库根目录：
2.1 最简转换
pandoc "docs/研发过程性材料-框架.md" -o "docs/研发过程性材料.docx"
2.2 生成带目录的版本（推荐甲方用）
pandoc "docs/研发过程性材料-框架.md" -o "docs/研发过程性材料.docx" \
--toc \
--toc-depth=3 \
-V lang=zh-CN \
-V mainfont="Microsoft YaHei" \
-V geometry:margin=2.5cm
2.3 加样式的版本（更正式）
如果你有 reference.docx 模板（标题、表格、代码块样式）：
pandoc "docs/研发过程性材料-框架.md" \
-o "docs/研发过程性材料.docx" \
--reference-doc=docs/reference.docx \
--toc --toc-depth=3
3. 填图/视频工作流
- 在 Word 中打开
研发过程性材料.docx。 - 找到每个
[📷 图片占位 — 描述]（Word 中显示为 Markdown 文本），删除占位符，插入 → 图片。 - 每个
[🎬 视频占位 — 描述]：插入 → 联机视频（B站/腾讯视频URL）或 插入 → 对象 → 媒体（本地 MP4）。 - 填完所有
[📝 占位 ...]与代码片段。 - 最终交付前：
- 检查所有 ⏳ 项，确认是否纳入正式交付
- 更新封面日期与版本号
- 导出 PDF 一并交付（
文件 → 另存为 → PDF）
4. 备选方案（不装 Pandoc）
| 方案 | 操作 | 优缺点 |
|---|---|---|
| VSCode 插件 | 装 Markdown PDF / Markdown Word 扩展，右键导出 |
简单，但样式不如 Pandoc |
| 在线工具 | https://cloudconvert.com/md-to-docx 上传 → 下载 |
零安装，但内容会过第三方服务器 |
| Typora | 导入 md → 导出 docx | 商业软件，样式好 |
| PowerShell + Word COM | 自动调用 Word.Application 转换（需 Word 已装） | 可批处理但脚本较复杂 |
如要 PowerShell + Word COM 脚本，告诉我我写给你。
5. 文件位置
| 文件 | 路径 |
|---|---|
| Markdown 源（你填这个） | docs/研发过程性材料-框架.md |
| Word 输出（待生成） | docs/研发过程性材料.docx |
| 图片（建议） | docs/images/（自己建） |
| 视频（建议） | docs/videos/（自己建） |
| 引用样式模板（可选） | docs/reference.docx |