python-docx

Python Docx

概要

Python-docxは、Microsoft Word（.docx）ドキュメントを作成、操作するためのPythonライブラリです。このスキルでは、次のようなドキュメント自動化の包括的なパターンを扱います。

• ドキュメントの作成：新規作成またはテンプレートからの作成
• 段落の書式設定：スタイル、フォント、配置
• 表の生成：セルの結合、スタイル、書式設定
• ヘッダーとフッター：ページ番号や動的コンテンツ
• 画像の挿入：サイズ調整と配置
• スタイル管理：ドキュメントの外観の統一
• テンプレートの操作：ドキュメントのワークフロー向け
• 差し込み印刷のパターン：ドキュメントの一括生成向け

このスキルを使用する場面

次の場合に使用します。

• データからプログラムでWordドキュメントを作成する
• 一貫した書式のレポートを生成する
• 契約書、請求書、法的文書を作成する
• テンプレートベースのドキュメント作成を自動化する
• 既存のWordドキュメントを変更する
• 複雑な表構造を含むドキュメントを作成する
• コードブロックを含む技術文書を生成する
• ヘッダーやフッターを含む複数セクションのドキュメントを作成する
• 画像やグラフを埋め込んだドキュメントを作成する
• ドキュメント生成を一括処理する

次の場合には使用しません。

• 単純なテンプレートへのデータ入力（代わりにdocx-templatesを使用してください）
• 最終出力がPDFの場合（代わりにpypdfまたはreportlabを使用してください）
• リアルタイムの共同編集が必要な場合
• 複雑なマクロやVBAが必要な場合
• 複雑なWord機能を保持する必要がある場合（WindowsでCOMオートメーションを使用してください）
• ドキュメントからテキストを抽出するだけの場合（代わりにpython-docx2txtを使用してください）

前提条件

インストール

# Using pip
pip install python-docx

# Using uv (recommended)
uv pip install python-docx

# With image support
pip install python-docx Pillow

# Full installation with all optional dependencies
pip install python-docx Pillow lxml

インストールの確認

from docx import Document
from docx.shared import Inches, Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT

print("python-docx installed successfully!")

バージョン履歴

1.0.0（2026-01-17）

• スキルの初回作成
• 中核機能のドキュメント化
• 6つの完全なコード例
• 統合パターン
• ベストプラクティスガイド
• トラブルシューティングのセクション

リソース

• 公式ドキュメント：https://python-docx.readthedocs.io/
• GitHubリポジトリ：https://github.com/python-openxml/python-docx
• PyPIパッケージ：https://pypi.org/project/python-docx/
• Open XML SDKリファレンス：https://docs.microsoft.com/en-us/office/open-xml/

関連スキル

• docx-templates - Wordドキュメント向けのJinja2形式のテンプレートレンダリング
• pypdf - PDFの操作と生成
• openpyxl - Excelファイルの自動化
• python-pptx - PowerPointプレゼンテーションの生成

---

このスキルでは、本番環境のドキュメント生成システムで磨き上げられた、Wordドキュメント自動化の包括的なパターンを紹介します。

サブスキル

• 1. 基本的なドキュメントの作成
• 2. 高度な段落の書式設定
• 3. 表の作成と書式設定
• 4. ヘッダー、フッター、ページ設定
• 5. 画像の挿入と配置
• 6. スタイル管理とカスタムスタイル
• データベースからのレポート生成（+1）
• ドキュメントの一括生成
• 1. ドキュメント構造（+3）
• 一般的な問題