md_to_docs_converter

Markdown ファイルを Word (.docx) に変換するツール。
Pandoc + カスタムスタイルテンプレート (templates/reference.docx) を使用します。

フォルダ構成

md_to_docs_converter/
├── convert.py          # 変換スクリプト
├── make_template.py    # スタイルテンプレート生成スクリプト
├── input/              # ここに .md を置く
├── output/             # 変換された .docx が生成される（git 管理外）
├── templates/
│   └── reference.docx  # Pandoc スタイルテンプレート
├── requirements.txt
└── .gitignore

必要環境

• Python 3.13+
• Pandoc: brew install pandoc

セットアップ

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python make_template.py   # templates/reference.docx を生成

使い方

# input/ 配下の .md をすべて output/ にミラー変換（基本操作）
python convert.py

# 単発ファイル
python convert.py input/lec02.md

# グロブパターン
python convert.py "input/2026spring/*.md"

# 出力先を指定
python convert.py input/lec02.md -o /tmp/

# テンプレートなし（Word デフォルトスタイル）
python convert.py input/lec02.md --no-template