96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# 框架转 Word（.docx）说明
|
||
|
||
> 当前环境（Git Bash）下未找到 `pandoc`，下面的方案需在你本机执行。
|
||
|
||
---
|
||
|
||
## 1. 安装 Pandoc（一次性）
|
||
|
||
### 方案 A：winget（Windows 11 自带，推荐）
|
||
```powershell
|
||
winget install JohnMacFarlane.Pandoc
|
||
```
|
||
安装完关闭当前 PowerShell / Git Bash，重新打开。
|
||
|
||
### 方案 B：Chocolatey
|
||
```powershell
|
||
choco install pandoc
|
||
```
|
||
|
||
### 方案 C：手动下载
|
||
到 https://github.com/jgm/pandoc/releases 下载最新版 `pandoc-X.X.X-windows-x86_64.msi` 双击装即可。
|
||
|
||
### 验证
|
||
```powershell
|
||
pandoc --version
|
||
```
|
||
看到版本号即成功。
|
||
|
||
---
|
||
|
||
## 2. 转 Word 命令
|
||
|
||
打开 PowerShell 或 Git Bash，`cd` 到仓库根目录：
|
||
|
||
### 2.1 最简转换
|
||
```bash
|
||
pandoc "docs/研发过程性材料-框架.md" -o "docs/研发过程性材料.docx"
|
||
```
|
||
|
||
### 2.2 生成带目录的版本（推荐甲方用）
|
||
```bash
|
||
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` 模板（标题、表格、代码块样式）：
|
||
```bash
|
||
pandoc "docs/研发过程性材料-框架.md" \
|
||
-o "docs/研发过程性材料.docx" \
|
||
--reference-doc=docs/reference.docx \
|
||
--toc --toc-depth=3
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 填图/视频工作流
|
||
|
||
1. 在 Word 中打开 `研发过程性材料.docx`。
|
||
2. 找到每个 `[📷 图片占位 — 描述]`（Word 中显示为 Markdown 文本），删除占位符，**插入 → 图片**。
|
||
3. 每个 `[🎬 视频占位 — 描述]`：**插入 → 联机视频**（B站/腾讯视频URL）或 **插入 → 对象 → 媒体**（本地 MP4）。
|
||
4. 填完所有 `[📝 占位 ...]` 与代码片段。
|
||
5. **最终交付前**：
|
||
- 检查所有 ⏳ 项，确认是否纳入正式交付
|
||
- 更新封面日期与版本号
|
||
- 导出 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` |
|