概要

本記事では、指定したディレクトリ配下のMarkdown（.md）ファイルや画像ファイル（例：.png）について、
ファイル名に特定のキーワードが含まれるものだけを抽出し、

Markdownはdocx（Word）形式に一括変換
画像ファイルはそのままコピー
するPythonスクリプトの作り方を解説します。

補足: NotionからGoogle Docsへ移行する必要があり、Notionからエクスポートした.mdファイルを.docx形式に一括変換してGoogle Docsにインポートする、という実際の業務ニーズが背景にあります。

変換・コピー先は、任意の出力ディレクトリ配下のサブフォルダ（例：output/SelectedFiles/）にまとめて格納されます。

こんな人におすすめ

プロジェクトや会議ごとにファイルを整理・変換したい
ファイル名でフィルタリングして一括処理したい
汎用的なバッチスクリプトの雛形が欲しい

ポイント

キーワードやフォルダ名は自由に設定可能
コマンドライン引数で柔軟にパス指定
画像以外にも拡張可能

コード例

convert_md_to_docx.py という名前で保存してください。

import os
import subprocess
import shutil
import sys

def convert_files_by_keyword(input_folder, output_folder, keyword_list, subfolder_name="SelectedFiles"):
    target_folder = os.path.join(output_folder, subfolder_name)
    if not os.path.exists(target_folder):
        os.makedirs(target_folder)
    for root, dirs, files in os.walk(input_folder):
        for file in files:
            file_path = os.path.join(root, file)
            rel_path = os.path.relpath(file_path, input_folder)
            safe_name = rel_path.replace(os.sep, '_')
            if any(keyword in file for keyword in keyword_list):
                if file.endswith('.md'):
                    docx_name = os.path.splitext(safe_name)[0] + '.docx'
                    docx_path = os.path.join(target_folder, docx_name)
                    subprocess.run([
                        'pandoc',
                        file_path,
                        '-o',
                        docx_path
                    ])
                    print(f'Converted: {file_path} -> {docx_path}')
                elif file.endswith('.png'):
                    img_name = safe_name
                    img_path = os.path.join(target_folder, img_name)
                    shutil.copy2(file_path, img_path)
                    print(f'Copied: {file_path} -> {img_path}')
            else:
                print(f'Skipped: {file_path} (No keyword in filename)')

if __name__ == '__main__':
    if len(sys.argv) < 4:
        print('Usage: python convert_md_to_docx.py <input_folder> <output_folder> <keyword1> [<keyword2> ...]')
        exit(1)
    input_folder = sys.argv[1]
    output_folder = sys.argv[2]
    keyword_list = sys.argv[3:]
    convert_files_by_keyword(input_folder, output_folder, keyword_list)

使い方

必要なパッケージ（pandoc）をインストール
- macOS: brew install pandoc
- Windows: 公式サイトからインストール
スクリプトを保存
コマンド例：

python convert_md_to_docx.py ./input ./output ProjectX Meeting

./input … 検索対象のディレクトリ
./output … 変換・コピー先のディレクトリ
ProjectX Meeting … ファイル名に含まれると対象となるキーワード（複数指定可）

解説

キーワードリストはコマンドライン引数で柔軟に指定できます。
サブフォルダ名（SelectedFiles）も関数引数で変更可能。
画像以外の拡張子もelifで追加可能。
ファイル名の重複を避けるため、元のパスを_で連結したファイル名にしています。

応用例

PDFや他の画像形式も同様に追加可能
サブディレクトリごとに分けて保存したい場合は、safe_nameの生成方法を工夫

まとめ

このスクリプトを使えば、特定のキーワードでファイルを一括抽出・変換・コピーできます。プロジェクトの自動整理やレポート作成の効率化にぜひご活用ください。