DOCX Reader Microsoft Word (.docx) ファイルをテキスト形式で読み込むスキルです。 クイックスタート 基本的な使い方
WSL環境でPythonスクリプトを実行
- wsl python3 scripts/read_docx.py
- "/mnt/c/path/to/file.docx"
- Markdown形式で保存
- スクリプトでテキスト抽出
- Write ツールで .md ファイルに保存
- 前提条件
- python-docx パッケージが必要です：
- wsl pip3
- install
- python-docx
- 使用例
- 例1: .docx ファイルを読み込んで内容を表示
- User: "C:\Users\keita\repos\file.docx を読み込んで"
- Assistant:
- 1. Windowsパスを WSL パスに変換: /mnt/c/Users/keita/repos/file.docx
- 2. wsl python3 scripts/read_docx.py を実行
- 3. 抽出されたテキストを表示
- 例2: .docx を Markdown に変換して保存
- User: "申請書.docx を Markdown に変換して保存"
- Assistant:
- 1. scripts/read_docx.py でテキスト抽出
- 2. Markdown形式で整形
- 3. Write ツールで 申請書.md に保存
- 4. 保存完了を報告
- ワークフロー
- 単一ファイルの読み込み
- ユーザーが .docx ファイルパスを指定
- Windows パスを WSL パス形式に変換 (
- C:\
- →
- /mnt/c/
- )
- wsl python3 scripts/read_docx.py
- を実行
- 抽出されたテキストを表示または保存
- 複数ファイルの一括処理
- Glob で .docx ファイルを検索
- 各ファイルに対してスクリプトを実行
- 結果をまとめて報告
- スクリプト詳細
- Python スクリプトは
- scripts/read_docx.py
- に配置されています。
- 主な機能:
- 段落テキストの抽出
- テーブルデータの抽出
- エラーハンドリング
- 使い方:
- python scripts/read_docx.py
- <
- file_path
- >
- 制限事項
- 画像は抽出されません
- 複雑なレイアウトは簡略化されます
- フォント情報、色などのスタイルは失われます
- 埋め込みオブジェクトは抽出されません
- トラブルシューティング
- python-docx がインストールされていない
- wsl pip3
- install
- python-docx
- "No module named 'docx'" エラー
- wsl pip3 uninstall docx
- wsl pip3
- install
- python-docx
- ファイルが開けない
- ファイルパスが正しいか確認（Windows → WSL パス変換）
- ファイルが他のプログラムで開かれていないか確認
- ファイルのアクセス権限を確認
- パス変換
- Windows パスから WSL パスへの変換：
- C:\Users...
- →
- /mnt/c/Users/...
- D:\Projects...
- →
- /mnt/d/Projects/...
- バックスラッシュ
- \
- をスラッシュ
- /
- に変換
- 関連ツール
- pandoc
-
- より高度な変換が必要な場合
- python-docx2txt
-
- 軽量な代替ライブラリ
- mammoth
- HTML形式での変換 バージョン履歴 v1.0.0 (2026-01-06): 初期リリース 基本的なテキスト抽出機能 テーブル抽出対応 WSL環境での動作