claude-office-skills/office-to-md

office-to-md は何をしますか？

Office文書（.docx, .xlsx, .pptx）をMarkdown形式に変換するAIエージェントスキル

このスキルを使用すると、Claude Codeや他のAIエージェントが一般的なOfficeファイルを直接読み取り、理解できるようになります。変換により、テーブル、リスト、画像参照、コードブロックなどが構造化されたMarkdownとして保持されます。

特徴

• Word文書（.docx） → Markdown
• Excelスプレッドシート（.xlsx） → Markdownテーブル
• PowerPointプレゼンテーション（.pptx） → Markdown（スライドごとに分割）
• 画像抽出：埋め込み画像は外部ファイルとして保存し、Markdown内で参照
• ファイル一括処理：ディレクトリ内の複数Officeファイルを一括変換

動作要件

• Python 3.8+
• 必要なPythonライブラリ：
  • python-docx
  • openpyxl
  • python-pptx
  • markdown（オプション）

インストール方法

pip install python-docx openpyxl python-pptx

基本的な使い方

from office_to_md import convert

# 単一ファイルの変換
convert('report.docx', 'report.md')
convert('data.xlsx', 'data.md')
convert('slides.pptx', 'slides.md')

# ディレクトリ内の全Officeファイルを変換
convert('./documents/', './output/')

CLIからの使用例

python office_to_md.py input.docx -o output.md
python office_to_md.py input.xlsx --tables
python office_to_md.py input.pptx --slides --extract-images

変換オプション

オプション	説明	デフォルト値
--tables	Excelテーブルを保持	True
--extract-images	埋め込み画像を抽出	True
--slides	スライドごとに分割	False
--encoding	出力エンコーディング	utf-8

注意事項

• 数式：Excelの数式は結果値のみ変換されます。
• 画像：抽出した画像は出力ディレクトリ内のimages/フォルダに保存されます。
• 書式：フォントサイズや色などの詳細な書式情報は失われます。Markdownでは対応できないためです。

ライセンス

MIT

関連スキル

• claude-office-skills/pdf-to-md
• claude-office-skills/csv-to-md
• claude-office-skills/html-to-md