pandoc-docx

Pandoc Docx

前提条件

确保已安装 Pandoc：

pandoc --version
# If not installed: brew install pandoc (macOS) or apt-get install pandoc (Linux)

目录设置

在项目根目录中创建工作目录：

mkdir -p import export

• import/ - 要转换的源文件
• export/ - 转换后的输出文件

转换为 DOCX

基本转换：

pandoc import/input.md -o export/output.docx

常用选项：

• --reference-doc=template.docx - 应用自定义样式
• --toc - 生成目录
• --toc-depth=2 - 设置目录深度
• --metadata="title=My Document" - 设置文档元数据

使用技能的中文模板：

# Path depends on where skill is installed:
# - Project local: .agents/skills/pandoc-docx/ (or your skill installation path)
# - Global: ~/.config/skills/pandoc-docx/ (varies by OS and tool)

pandoc import/input.md -o export/output.docx \
  --reference-doc=<skill-path>/assets/templates.docx

从 DOCX 转换

pandoc import/document.docx -o export/document.md --extract-media=export/images/

自定义模板

1. 生成默认模板：pandoc --print-default-data-file reference.docx > reference.docx
2. 在 Word 中编辑样式
3. 应用：pandoc import/input.md -o export/output.docx --reference-doc=reference.docx

批量处理

SKILL_PATH="<skill-path>"  # Adjust to your skill installation path

for file in import/*.md; do
  pandoc "$file" -o "export/$(basename "${file%.md}").docx" \
    --reference-doc=$SKILL_PATH/assets/templates.docx
done

资源

• assets/templates.docx - 中文 DOCX 模板，包含标题编号和代码高亮
• scripts/convert.sh - 转换辅助脚本（参见下方用法）
• references/pandoc-options.md - 完整选项参考和高级用法

使用 convert.sh

# Run from project root. Adjust <skill-path> to where skill is installed:
<skill-path>/scripts/convert.sh report.md report.docx

# With options
<skill-path>/scripts/convert.sh report.md report.docx --toc

# Absolute paths work as usual
<skill-path>/scripts/convert.sh /path/to/input.md /path/to/output.docx