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